Search and places

Yelp Business Lookup API

Search Yelp's native business lookup by query and exactly one of location or coordinates. Results follow the lookup's native order within its first 200 businesses. Category filters and alternative sorts are unsupported. A location Yelp cannot resolve returns a successful empty result with search_parameters.location_not_found set to true and consumes one search credit. Keep query, location, device, language, and limit unchanged when increasing page.

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`Required	Text to search for on the selected service.
`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.

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.

idtitlenameurlpositionthumbnailratingbusiness_idrankreview_countsnippetcityneighborhoodscoordinatescategoriespricephotos