m.yelp.com APIm.yelp.com ↗
Search Yelp businesses, fetch ratings, hours, categories, and reviews by alias. 4 endpoints covering search, details, reviews, and autocomplete suggestions.
curl -X GET 'https://api.parse.bot/scraper/e05ae8e2-83af-4fbd-acac-ab7d47268c2d/search_businesses?query=pizza&start=0&location=New+York%2C+NY' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for businesses by keyword and location. Returns a list of matching businesses with their name, alias, and URL. Results are parsed from the Yelp search page.
| Param | Type | Description |
|---|---|---|
| query | string | Search keyword or category (e.g. 'pizza', 'cafes', 'italian restaurants'). |
| start | integer | Pagination offset for results. |
| location | string | Location to search in (e.g. 'New York, NY', 'San Francisco, CA'). |
{
"type": "object",
"fields": {
"total": "integer count of businesses returned",
"businesses": "array of business objects each containing name, alias, and url"
},
"sample": {
"data": {
"total": 11,
"businesses": [
{
"url": "https://www.yelp.com/biz/l-industrie-pizzeria-new-york",
"name": "L’industrie Pizzeria",
"alias": "l-industrie-pizzeria-new-york"
},
{
"url": "https://www.yelp.com/biz/joes-pizza-new-york-148",
"name": "Joe's Pizza",
"alias": "joes-pizza-new-york-148"
}
]
},
"status": "success"
}
}About the m.yelp.com API
This API exposes 4 endpoints covering Yelp business search, detailed profiles, reviews, and autocomplete suggestions. Use search_businesses to find businesses by keyword and location, returning name, alias, and URL for each result. get_business_details returns structured data including star rating, review count, operating hours, address, and categories for any business identified by its alias slug.
Business Search and Details
The search_businesses endpoint accepts a query string (e.g. 'pizza', 'cafes'), a location string (e.g. 'San Francisco, CA'), and an optional start offset for pagination. It returns a businesses array of objects each containing name, alias, and url, plus a total count of matched results. The alias field is the slug you pass into the other endpoints.
get_business_details takes a required alias and returns a rich profile: name, rating, reviewCount, location (with address components), categories (each with title and alias), and operationHours broken down by day of the week. This is the right endpoint when you need structured hours or category data without parsing review text.
Reviews and Autocomplete
get_business_reviews accepts a required alias, an optional limit to control page size, and an optional after cursor for pagination. The response nests under a business object and exposes a reviews connection in edges/nodes format. Each node includes review text, star rating, author info, and photos. The pageInfo.endCursor value from one response feeds directly into the after parameter of the next call.
The autocomplete endpoint takes a required text prefix and an optional location context. It returns a response array of suggestion groups, each with a prefix and a suggestions array of matching terms and categories. A unique_request_id is also returned, useful for logging and deduplication. This endpoint is suited for building search-as-you-type interfaces backed by Yelp's suggestion data.
- Build a restaurant discovery app that searches by cuisine keyword and city using
search_businesses - Aggregate business hours and category tags from
get_business_detailsfor a local directory - Pull paginated customer reviews with ratings and photos via
get_business_reviewsfor sentiment analysis - Implement a type-ahead search box using
autocompletewith location context - Track average star rating and review count changes over time for specific business aliases
- Compile category-tagged business lists across multiple cities for market research
- Cross-reference Yelp review counts and ratings against other data sources for competitive analysis
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Yelp have an official developer API?+
What does `get_business_reviews` return beyond review text?+
reviewCount and rating. Pagination is cursor-based: use the pageInfo.endCursor value from one response as the after parameter in the next call. The limit parameter controls how many reviews are returned per page.Does `search_businesses` return full business details like hours or phone numbers?+
search_businesses returns only name, alias, and url per business, plus a total count. To get hours, categories, rating, and full address, pass the alias from the search result into get_business_details. You can fork this API on Parse and revise it to merge those two calls into a single enriched search response if your use case requires it.Is there a way to filter reviews by rating or date?+
get_business_reviews does not currently expose filtering by star rating or date; results are sorted by relevance by default. The endpoint supports cursor-based pagination via the after parameter and a limit per page. You can fork this API on Parse and revise it to add sorting or filtering parameters if that behavior is available from the underlying source.Does the API return menu data or photos beyond review photos?+
get_business_details includes business photos as part of the profile, and get_business_reviews returns photos attached to individual reviews. You can fork this API on Parse and revise it to add a dedicated photos or menu endpoint.