Search and places

Yelp Search API

Yelp business search API. Find local businesses by query and location or coordinates and get ratings, review counts, and Yelp IDs as JSON.

Search Yelp businesses by query and area. Category, attribute, neighborhood, alternative sort and regional-domain selections use standard search. Unfiltered US relevance requests retain native business lookup. Pagination is limited to the first 200 businesses.

Try in the request builder API reference Connect with MCP

Make a request

Use your existing PrismCrawl API key and credit balance. A completed request consumes one credit, including recognized empty or unavailable results and source changes found during a valid continuation. Validation and operational errors remain uncharged. Each completed continuation request is billed separately.

POST /v1/yelp/search

curl 'https://api.prismcrawl.com/v1/yelp/search' \
  --request POST \
  --header 'content-type: application/json' \
  --header 'x-api-key: <PRISMCRAWL_API_KEY>' \
  --data '{
  "location": "Austin, TX",
  "query": "restaurants"
}'

Supported parameters

Parameter	Usage
`query`	Optional business search text. Omit to browse businesses in the selected area.
`language`	Provider-supported language code, such as en.
`location`	Location to search around, such as Austin, TX. Yelp Business Lookup requires exactly one of location or coordinates. If Yelp cannot resolve the location, a completed lookup returns HTTP 200 with an empty results array and search_parameters.location_not_found: true. This successful response costs one credit.
`coordinates`	Latitude and longitude for location targeting. Yelp Business Lookup requires exactly one of location or coordinates. If Yelp cannot resolve the location, a completed lookup returns HTTP 200 with an empty results array and search_parameters.location_not_found: true. This successful response costs one credit.
`page`	One-based page within the first 200 businesses. The starting offset (page - 1) × limit must be less than 200. With limit 20, pages 1 through 10 are available. Keep the other search parameters unchanged.
`limit`	Maximum businesses to return, from 1 to 100; defaults to 20. The final page stops at Yelp's 200-result lookup window.
`sort_by`	Omit this field or use recommended for Yelp's native business lookup order. Rating, review-count, and distance sorting are unsupported. recommended
`device`	Device presentation for the source request. desktop, mobile, tablet
`html`	Return the encoded original response rather than parsed JSON.
`zero_trace`	Do not archive source or parsed response artifacts.
`start`	Result offset within the first 200 businesses. Use this or page; a final page can contain fewer than limit results.
`l`	Source geographic box g:west,south,east,north or neighborhood selection p:region:city::neighborhood. A neighborhood requires location. Cannot be combined with coordinates.
`cflt`	Comma-separated native category aliases.
`attrs`	Comma-separated native attribute filters, for example GoodForKids,DogsAllowed.
`yelp_domain`	Yelp regional domain. yelp.at, yelp.be, yelp.ca, yelp.ch, yelp.cl, yelp.co.jp, yelp.co.nz, yelp.co.uk, yelp.com, yelp.com.ar, yelp.com.au, yelp.com.br, yelp.com.hk, yelp.com.mx, yelp.com.ph, yelp.com.sg, yelp.com.tr, yelp.com.tw, yelp.cz, yelp.de, yelp.dk, yelp.es, yelp.fi, yelp.fr, yelp.ie, yelp.it, yelp.my, yelp.nl, yelp.no, yelp.pl, yelp.pt

Structured results

Read items from data.content.results. The response also includes the search metadata, pagination state, and any extracted SERP features. Optional fields appear when supplied by the provider.

Results come from Yelp's native business lookup and follow its own result order. Use each result's id to request Yelp Reviews. Pagination covers the first 200 businesses; keep the query, location, device, language, and limit unchanged when increasing page. Category filters and rating, review-count, or distance sorting return a validation error. Search metadata identifies source: business_lookup and pagination_limit: 200. If Yelp cannot resolve the supplied location, a completed lookup returns HTTP 200 with an empty results array, search_parameters.location_not_found: true, source_result_count: 0, and has_next_page: false. This successful empty response costs one credit. Invalid request controls remain uncharged.

addressbusiness_idcategoriescitycoordinatesengineidnameneighborhoodsphonephotospositionpricerankratingreview_countsnippetthumbnailtitletypeurl

SDKs and guides

The official SDKs cover this endpoint with typed parameters, automatic retries, and pagination helpers.

Python SDK: pip install prismcrawl
Node.js SDK: npm install prismcrawl
Tutorial: Scrape Google Maps, Yelp, and Tripadvisor reviews with Python

Frequently asked questions

Do I need a Yelp API key?

No. You authenticate with your PrismCrawl API key in the x-api-key header. You do not need a Yelp developer account or Yelp API key.

How do I get reviews for a business?

Pass the id from a Yelp Business Lookup result to the Yelp Reviews API to page through that business's reviews with native sorting.

How much does the Yelp API cost?

Each completed Yelp request uses one credit. Credits cost $0.30–$0.15 per 1,000 depending on the package, with no subscription, and new accounts receive 100 free credits. Validation and operational errors are not charged.