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.

MEDIAN LAGon demand
PARAMETERS8
TOTAL USERS71
MONTHLY ACTIVE22
TOTAL RUNS7,679
SUCCESS (30D)99.8%
RATING5.0 (4)
LAST MODIFIED2026-11-15
PUBLISHED2026-05

Input parameters

PARAMETERTYPEREQDEFAULTDESCRIPTION
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

Basic — the required input, with the schema's own example values
{
  "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.