Search and places

Yelp Reviews API

Yelp Reviews API returning complete review text, ratings, and authors for a business, with Yelp's native sorting and page-based pagination.

Return Yelp business reviews by alias or encoded business ID. Filter recommended reviews by text and ratings, or select not-recommended reviews with their separate offset. Keep filters, language, sorting, and limit unchanged when paginating.

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/reviews

curl 'https://api.prismcrawl.com/v1/yelp/reviews' \
  --request POST \
  --header 'content-type: application/json' \
  --header 'x-api-key: <PRISMCRAWL_API_KEY>' \
  --data '{
  "id": "halcyon-austin-2"
}'

Supported parameters

Parameter	Usage
`id`Required	The business alias from its Yelp URL, such as halcyon-austin-2.
`language`	Provider-supported language code, such as en.
`page`	One-based page number.
`limit`	Maximum number of items to return. The provider may return fewer.
`sort_by`	The provider's supported sort order. recommended, newest, oldest, highest_rating, lowest_rating, elites
`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.
`query`	Text to search for on the selected service.
`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
`rating`	Comma-separated review star ratings.
`start`	Zero-based offset in recommended reviews.
`not_recommended`	Return reviews that Yelp does not currently recommend.
`not_recommended_start`	Zero-based offset in not-recommended reviews.

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.

authorauthor_imageauthor_urlbusiness_iddatedate_textdeveloper_responseenginehelpful_votesidis_excerptlanguagenamenot_recommendedphotospositionpublished_atrankratingrating_maxsourcetextthumbnailtitletypeupdated_aturlversionvote_count

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