scraper
Back to API docs

Overview

  • Overview

APIs

  • POSTReviews
  • POSTBusiness Profile
  • POSTSearch

Yelp Search

1 credit

Search for businesses on Yelp by term, location, or coordinates.

POST/api/v1/tools/yelp/search

Parameters

termstring

Search term (e.g. "pizza", "plumber"). At least one of term, location, or latitude+longitude required.

locationstring

Location string (e.g. "San Francisco, CA").

latitudenumber

Latitude (-90 to 90). Must be paired with longitude.

longitudenumber

Longitude (-180 to 180). Must be paired with latitude.

categorystring

Category filter.

maxResultsnumber

Maximum results (1-200). Defaults to 20.

sortstring

"default", "distance", "rating", "review_count".

radiusnumber

Search radius in meters.

Response Schema

dataobject

Search results

resultsobject[]

Array of matching businesses

countnumber

Number of results returned

metaobject

Request metadata

toolstring

Tool name (yelp-search)

creditsUsednumber

Credits consumed (1)

requestIdstring

Unique request ID

Request

curl -X POST https://scraper.run/api/v1/tools/yelp/search \
-H "Authorization: Bearer sc_live_..." \
-H "Content-Type: application/json" \
-d '{
"term": "pizza",
"location": "San Francisco, CA",
"maxResults": 10
}'

Response Example

{
"data": {
"results": [
{
"id": "v2GpHEjNRMGZFIqkXnPh4g",
"alias": "tonys-pizza-napoletana-san-francisco",
"name": "Tony's Pizza Napoletana",
"rating": 4.4,
"reviewCount": 4521,
"categories": [
{
"alias": "pizza",
"title": "Pizza"
}
],
"priceRange": "$$",
"location": {
"address1": "1570 Stockton St",
"city": "San Francisco",
"state": "CA",
"postalCode": "94133",
"country": "US"
},
"coordinates": {
"latitude": 37.80027,
"longitude": -122.40898
}
},
{
"id": "lJAGnYzku5zSaLnQ_T6_GQ",
"alias": "golden-boy-pizza-san-francisco",
"name": "Golden Boy Pizza",
"rating": 4.3,
"reviewCount": 3218,
"categories": [
{
"alias": "pizza",
"title": "Pizza"
}
],
"priceRange": "$",
"location": {
"address1": "542 Green St",
"city": "San Francisco",
"state": "CA",
"postalCode": "94133",
"country": "US"
},
"coordinates": {
"latitude": 37.79983,
"longitude": -122.40775
}
}
],
"count": 2
},
"meta": {
"tool": "yelp-search",
"creditsUsed": 1,
"requestId": "req_def456"
}
}