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"
  }
}