Yelp Search API
Scrape Yelp search results - ranked local business listings with rating, reviews, price, categories, phone, and neighborhood. Filter by category, sort by rating or review count, paginate, and get the place IDs to pull full details and reviews.
Input parameters
| PARAMETER | TYPE | REQ | DEFAULT | DESCRIPTION |
|---|---|---|---|---|
| location | string | yes | — | Set the geographic location to search in (the Yelp 'find_loc' box). |
| search_term | string | no | — | Set the Yelp search query (the 'find_desc' box). |
| category_filter | string | no | — | Restrict results to a Yelp category alias (the 'cflt' value). |
| sort_by | enum | no | — | Order the results. 'recommended' is the Yelp default; 'rating' sorts by highest rated; 'review_count' sorts by most reviewed. |
| attrs | string | no | — | Refine results by price and feature attributes (the 'attrs' value). |
| radius_filter | string | no | — | Narrow results to a distance radius or a neighborhood (the 'l' value). |
| yelp_domain | string | no | — | Choose which regional Yelp domain to query (e.g. 'yelp.com', 'yelp.co.uk', 'yelp.fr', 'yelp.de'). |
| max_pages | integer | no | 1 | Set the maximum number of result pages to fetch (1-indexed). — drives your bill |
Worked examples
{
"location": "New York, NY"
}
Code
curl
curl -X POST "https://api.apify.com/v2/acts/johnvc~yelp-search-api/run-sync-get-dataset-items" \
-H "Authorization: Bearer $APIFY_TOKEN" \
-H "Content-Type: application/json" \
-d '{"location": "New York, NY"}'
Python
from apify_client import ApifyClient
client = ApifyClient("APIFY_TOKEN")
run = client.actor("johnvc/yelp-search-api").call(
run_input={'location': 'New York, NY'}
)
for item in client.dataset(run.default_dataset_id).iterate_items():
print(item)
MCP
Apify's hosted MCP server loads this source from the URL below as the tool johnvc--yelp-search-api. Sign in to Apify when your client asks (OAuth), or send an Apify token as an Authorization: Bearer header.
https://mcp.apify.com/?tools=johnvc/yelp-search-api
Questions people ask
Does Yelp have an API for search results as JSON?
This Yelp Search API scrapes Yelp search results and returns ranked local business listings as JSON with rating, reviews, price, categories, phone and neighborhood, plus the place IDs you need to pull full details and reviews.
How do I scrape Yelp data with the Yelp Search API?
Pass a location such as New York, NY, the only required input, and a search_term for what to find. Restrict with category_filter, attrs for price and feature attributes, and radius_filter for a distance or neighborhood; set max_pages for more result pages.
Is the Yelp Search API free to use?
There is a free tier on Apify. Beyond it, the default Pay per page edition is priced at 0.01 USD per page of results, and max_pages (default 1) is the input that drives the total.
Can I sort Yelp Search API results by rating or review count?
Yes. sort_by accepts recommended, the Yelp default, rating for the highest rated first, or review_count for the most reviewed first.
Which regional Yelp domains does the Yelp Search API support?
Set yelp_domain to choose the regional site to query, for example yelp.com, yelp.co.uk, yelp.fr or yelp.de.
Can Claude or Cursor call the Yelp Search API?
Yes. The source is exposed as an MCP tool on Apify's hosted MCP server, so Claude, Cursor and other agents can call it directly, and it is also available over REST with curl or the Apify Python client.