Endpoint Playground

Try the Yelp business search API

Test Crawlora's Yelp business search API with realistic prefilled parameters. Generate a cURL request, inspect the expected structured JSON response, and open the full docs or pricing page when you are ready to integrate this public web data extraction endpoint into your application.

Endpoint facts

Method: GET
API path: /yelp/search
Platform: Yelp
Auth: apiKey
Credits: 3 credits/request
Required params: term, location
Common optional params: limit, offset

Yelp business search API documentation Yelp platform page Crawlora API pricing Try Yelp Business API Try Yelp Business Menu API Try Yelp Business Photos API Try Yelp Business Reviews API Try Yelp Business Review Highlights API

Prefilled cURL

curl "https://api.crawlora.net/api/v1/yelp/search?term=<term>&location=<location>" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Request parameters visible to crawlers

Parameter	Type	Required	Description
term	string	Yes	Search term
location	string	Yes	Neighborhood, city, state, or zip code
limit	integer	No	Max results to return, 1-50
offset	integer	No	Pagination offset

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "term": "pizza",
    "location": "Chicago, IL",
    "limit": 3,
    "offset": 0,
    "total": 240,
    "results": [
      {
        "id": "pequods-pizza-chicago-3",
        "alias": "pequods-pizza-chicago-3",
        "encoded_id": "DXwSYgiXqIVNdO9dazel6w",
        "name": "Pequod's Pizza",
        "url": "https://www.yelp.com/biz/pequods-pizza-chicago-3",
        "photos": [
          "https://s3-media0.fl.yelpcdn.com/bphoto/8QJUNblfCI0EDhOjuIWJ4A/ms.jpg"
        ],
        "rating": 4,
        "review_count": 8947,
        "price": "$$",
        "categories": [
          "Pizza"
        ],
        "address": "2207 N Clybourn Ave, Chicago, IL 60614",
        "address_details": {
          "address_line_1": "2207 N Clybourn Ave",
          "city": "Chicago",
          "state": "IL",
          "postal_code": "60614",
          "country": "US"
        },
        "coordinates": {
          "latitude": 41.92187,
          "longitude": -87.664486
        },
        "neighborhoods": [
          "DePaul"
        ],
        "phone": "7733271512",
        "phone_number": "(773) 327-1512",
        "closed": false
      }
    ]
  }
}

Public Playground

Preview the endpoint before sending a live request

Sample responses, schemas, request previews, and code snippets are visible before sign in. Create an account when you are ready to save an API key and run authenticated requests.

Set up API key Endpoint docs

Endpoint

Choose one catalog endpoint for this request.

8 shown

Group

Method

Auth

Endpoint

GETapiKey3 credits/requestyelp.mobileSearchResponseDocYelp

GET /yelp/search

Search Yelp businesses

Searches Yelp's real Android app business-search backend for a term and location. Credential-free: no login, no API key, no cookie required from the caller.

API key required. Paste a full key or rotate one from the API Keys page.

Set up API key

View docs

API key

API key required for live requests. Your key is only used to send requests from this Playground.

not configured

Active Playground key: not configured

Manage API keys in Console

Required query parameters

term

requiredstring

Search termlocation

requiredstring

Neighborhood, city, state, or zip code

Add an API key to send a live request.

If an active API key is configured, Copy cURL includes it. Share links never include API keys.

View docs

Sample responseGET

Shown before your first request. Add an API key and send a request to see the live response, status, latency, and headers.

{
  "code": 200,
  "msg": "OK",
  "data": {
    "term": "pizza",
    "location": "Chicago, IL",
    "limit": 3,
    "offset": 0,
    "total": 240,
    "results": [
      {
        "id": "pequods-pizza-chicago-3",
        "alias": "pequods-pizza-chicago-3",
        "encoded_id": "DXwSYgiXqIVNdO9dazel6w",
        "name": "Pequod's Pizza",
        "url": "https://www.yelp.com/biz/pequods-pizza-chicago-3",
        "photos": [
          "https://s3-media0.fl.yelpcdn.com/bphoto/8QJUNblfCI0EDhOjuIWJ4A/ms.jpg"
        ],
        "rating": 4,
        "review_count": 8947,
        "price": "$$",
        "categories": [
          "Pizza"
        ],
        "address": "2207 N Clybourn Ave, Chicago, IL 60614",
        "address_details": {
          "address_line_1": "2207 N Clybourn Ave",
          "city": "Chicago",
          "state": "IL",
          "postal_code": "60614",
          "country": "US"
        },
        "coordinates": {
          "latitude": 41.92187,
          "longitude": -87.664486
        },
        "neighborhoods": [
          "DePaul"
        ],
        "phone": "7733271512",
        "phone_number": "(773) 327-1512",
        "closed": false
      }
    ]
  }
}

Endpoint details

Searches Yelp's real Android app business-search backend for a term and location. Credential-free: no login, no API key, no cookie required from the caller.

Method: GET
Path: /yelp/search
Authentication: apiKey
Credit cost: 3 credits/request
Platform: Yelp
Parameters: 5 documented fields

Request parameters

term:querylocation:querylimit:queryoffset:queryx-api-key:header

Response schema fields

codedatadata.limitdata.locationdata.offsetdata.resultsdata.results[].addressdata.results[].address_detailsdata.results[].address_details.address_line_1data.results[].address_details.address_line_2data.results[].address_details.address_line_3data.results[].address_details.city

Sample response summary

{
  "code": 200,
  "msg": "OK",
  "data": {
    "term": "pizza",
    "location": "Chicago, IL",
    "limit": 3,
    "offset": 0,
    "total": 240,
    "results": [
      {
        "id": "pequods-pizza-chicago-3",
        "alias": "pequods-pizza-chicago-3",
        "encoded_id": "DXwSYgiXqIVNdO9dazel6w",
        "name": "Pequod's Pizza",
        "url": "https://www.yelp.com/biz/pequods-pizza-chicago-3",
        "photos": [
          "https://s3-media0.fl.yelpcdn.com/bphoto/8QJUNblfCI0EDhOjuIWJ4A/ms.jpg"
        ],
        "rating": 4,
        "review_count": 8947,
        "price": "$$",
        "categories": [
          "Pizza"
        ],
        "address": "2207 N Clybourn Ave, Chicago, IL 60614",
        "address_details": {
          "address_line_1": "2207 N Clybourn Ave",
          "city": "Chicago",
          "state": "IL",
          "postal_code": "60614",
          "country": "US"
        },
        "coordinates": {
          "latitude": 41.92187,
          "longitude": -87.664486
        },
        "neighborhoods": [
          "DePaul"
        ],
        "phone": "7733271512",
        "phone_number": "(773) 327-1512",
        "closed": false
      }
    ]
  }
}

cURL example

curl "https://api.crawlora.net/api/v1/yelp/search?term=<term>&location=<location>" \
  -H "x-api-key: $CRAWLORA_API_KEY"

View endpoint docs Open platform page Browse all endpoints Pricing Get Yelp business detail Get Yelp business menu Get Yelp business photos Get Yelp business reviews Get Yelp business review highlights

Endpoint Playground

Try the Yelp business search API

Endpoint facts

Method: GET
API path: /yelp/search
Platform: Yelp
Auth: apiKey
Credits: 3 credits/request
Required params: term, location
Common optional params: limit, offset

Prefilled cURL

curl "https://api.crawlora.net/api/v1/yelp/search?term=<term>&location=<location>" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Request parameters visible to crawlers

Parameter	Type	Required	Description
term	string	Yes	Search term
location	string	Yes	Neighborhood, city, state, or zip code
limit	integer	No	Max results to return, 1-50
offset	integer	No	Pagination offset

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "term": "pizza",
    "location": "Chicago, IL",
    "limit": 3,
    "offset": 0,
    "total": 240,
    "results": [
      {
        "id": "pequods-pizza-chicago-3",
        "alias": "pequods-pizza-chicago-3",
        "encoded_id": "DXwSYgiXqIVNdO9dazel6w",
        "name": "Pequod's Pizza",
        "url": "https://www.yelp.com/biz/pequods-pizza-chicago-3",
        "photos": [
          "https://s3-media0.fl.yelpcdn.com/bphoto/8QJUNblfCI0EDhOjuIWJ4A/ms.jpg"
        ],
        "rating": 4,
        "review_count": 8947,
        "price": "$$",
        "categories": [
          "Pizza"
        ],
        "address": "2207 N Clybourn Ave, Chicago, IL 60614",
        "address_details": {
          "address_line_1": "2207 N Clybourn Ave",
          "city": "Chicago",
          "state": "IL",
          "postal_code": "60614",
          "country": "US"
        },
        "coordinates": {
          "latitude": 41.92187,
          "longitude": -87.664486
        },
        "neighborhoods": [
          "DePaul"
        ],
        "phone": "7733271512",
        "phone_number": "(773) 327-1512",
        "closed": false
      }
    ]
  }
}

Public Playground

Preview the endpoint before sending a live request

Sample responses, schemas, request previews, and code snippets are visible before sign in. Create an account when you are ready to save an API key and run authenticated requests.

Set up API key Endpoint docs

Endpoint

Choose one catalog endpoint for this request.

8 shown

Group

Method

Auth

Endpoint

GETapiKey3 credits/requestyelp.mobileSearchResponseDocYelp

GET /yelp/search

Search Yelp businesses

Searches Yelp's real Android app business-search backend for a term and location. Credential-free: no login, no API key, no cookie required from the caller.

API key required. Paste a full key or rotate one from the API Keys page.

Set up API key

View docs

API key

API key required for live requests. Your key is only used to send requests from this Playground.

not configured

Active Playground key: not configured

Manage API keys in Console

Required query parameters

term

requiredstring

Search termlocation

requiredstring

Neighborhood, city, state, or zip code

Add an API key to send a live request.

If an active API key is configured, Copy cURL includes it. Share links never include API keys.

View docs

Sample responseGET

Shown before your first request. Add an API key and send a request to see the live response, status, latency, and headers.

{
  "code": 200,
  "msg": "OK",
  "data": {
    "term": "pizza",
    "location": "Chicago, IL",
    "limit": 3,
    "offset": 0,
    "total": 240,
    "results": [
      {
        "id": "pequods-pizza-chicago-3",
        "alias": "pequods-pizza-chicago-3",
        "encoded_id": "DXwSYgiXqIVNdO9dazel6w",
        "name": "Pequod's Pizza",
        "url": "https://www.yelp.com/biz/pequods-pizza-chicago-3",
        "photos": [
          "https://s3-media0.fl.yelpcdn.com/bphoto/8QJUNblfCI0EDhOjuIWJ4A/ms.jpg"
        ],
        "rating": 4,
        "review_count": 8947,
        "price": "$$",
        "categories": [
          "Pizza"
        ],
        "address": "2207 N Clybourn Ave, Chicago, IL 60614",
        "address_details": {
          "address_line_1": "2207 N Clybourn Ave",
          "city": "Chicago",
          "state": "IL",
          "postal_code": "60614",
          "country": "US"
        },
        "coordinates": {
          "latitude": 41.92187,
          "longitude": -87.664486
        },
        "neighborhoods": [
          "DePaul"
        ],
        "phone": "7733271512",
        "phone_number": "(773) 327-1512",
        "closed": false
      }
    ]
  }
}

Endpoint details

Searches Yelp's real Android app business-search backend for a term and location. Credential-free: no login, no API key, no cookie required from the caller.

Method: GET
Path: /yelp/search
Authentication: apiKey
Credit cost: 3 credits/request
Platform: Yelp
Parameters: 5 documented fields

Request parameters

term:querylocation:querylimit:queryoffset:queryx-api-key:header

Response schema fields

Sample response summary

{
  "code": 200,
  "msg": "OK",
  "data": {
    "term": "pizza",
    "location": "Chicago, IL",
    "limit": 3,
    "offset": 0,
    "total": 240,
    "results": [
      {
        "id": "pequods-pizza-chicago-3",
        "alias": "pequods-pizza-chicago-3",
        "encoded_id": "DXwSYgiXqIVNdO9dazel6w",
        "name": "Pequod's Pizza",
        "url": "https://www.yelp.com/biz/pequods-pizza-chicago-3",
        "photos": [
          "https://s3-media0.fl.yelpcdn.com/bphoto/8QJUNblfCI0EDhOjuIWJ4A/ms.jpg"
        ],
        "rating": 4,
        "review_count": 8947,
        "price": "$$",
        "categories": [
          "Pizza"
        ],
        "address": "2207 N Clybourn Ave, Chicago, IL 60614",
        "address_details": {
          "address_line_1": "2207 N Clybourn Ave",
          "city": "Chicago",
          "state": "IL",
          "postal_code": "60614",
          "country": "US"
        },
        "coordinates": {
          "latitude": 41.92187,
          "longitude": -87.664486
        },
        "neighborhoods": [
          "DePaul"
        ],
        "phone": "7733271512",
        "phone_number": "(773) 327-1512",
        "closed": false
      }
    ]
  }
}

cURL example

curl "https://api.crawlora.net/api/v1/yelp/search?term=<term>&location=<location>" \
  -H "x-api-key: $CRAWLORA_API_KEY"