Yelp Search API
Scrape Yelp Search data with one API call. Searches Yelp businesses by term and location. Returns a unified PlaceList of 10 businesses a page: the 22-character encid as place.id (use it on GET /v1/yelp/business/info and /v1/yelp/business/reviews), name, Yelp URL, unrounded star rating, review count, price level, address, coordinates, categories, and photos, with the total number of matches. Results are in Yelp's recommended order; sort=rating and sort=review_count are refused with a free 400. ads=true adds sponsored businesses after the regular results. Page with cursor from next_cursor. A location Yelp does not cover returns an empty list and is not billed.
Last updated October 2026Maintained by the SocialCrawl team
Returns Yelp businesses matching a term and location as a PlaceList with name, rating, review count, and location fields when the provider returns rows. Sort, ads, and cursor are optional.
Use it to find businesses before business/info. query and location are required. If the provider reports a non-zero total with no rows, the call fails and is refunded.
Searching 68 platforms in parallel
TikTok·
Instagram·
YouTube·
Facebook·
X·
LinkedIn·
Reddit·
Threads·
Pinterest·
Twitch·
Truth Social·
Snapchat·
Kick·
Bluesky·
Kwai·
Rumble·
Spotify·
Apple Music·TikTok Shop·
Amazon Shop·
Google Shopping·
Trustpilot·
TripAdvisor·Yelp·
Linktree·
Komi·
Pillar·
lnk.bio·Facebook Ads·Google Ads·LinkedIn Ads·Google Search·Google News·
Finance·
Polymarket·
Tavily·
Hacker News·
GitHub·
Perplexity·
Naver·
Utility·
Universal SearchTikTok·Instagram·YouTube·Facebook·X·LinkedIn·Reddit·Threads·Pinterest·Twitch·Truth Social·Snapchat·Kick·Bluesky·Kwai·Rumble·Spotify·Apple Music·TikTok Shop·Amazon Shop·Google Shopping·Trustpilot·TripAdvisor·Yelp·Linktree·Komi·Pillar·lnk.bio·Facebook Ads·Google Ads·LinkedIn Ads·Google Search·Google News·Finance·Polymarket·Tavily·Hacker News·GitHub·Perplexity·Naver·Utility·Universal SearchTikTok·Instagram·YouTube·Facebook·X·LinkedIn·Reddit·Threads·Pinterest·Twitch·Truth Social·Snapchat·Kick·Bluesky·Kwai·Rumble·Spotify·Apple Music·TikTok Shop·Amazon Shop·Google Shopping·Trustpilot·TripAdvisor·Yelp·Linktree·Komi·Pillar·lnk.bio·Facebook Ads·Google Ads·LinkedIn Ads·Google Search·Google News·Finance·Polymarket·Tavily·Hacker News·GitHub·Perplexity·Naver·Utility·Universal SearchTikTok·Instagram·YouTube·Facebook·X·LinkedIn·Reddit·Threads·Pinterest·Twitch·Truth Social·Snapchat·Kick·Bluesky·Kwai·Rumble·Spotify·Apple Music·TikTok Shop·Amazon Shop·Google Shopping·Trustpilot·TripAdvisor·Yelp·Linktree·Komi·Pillar·lnk.bio·Facebook Ads·Google Ads·LinkedIn Ads·Google Search·Google News·Finance·Polymarket·Tavily·Hacker News·GitHub·Perplexity·Naver·Utility·Universal SearchWhat can you do with the Search API?
The Search endpoint gives you structured Yelp data with computed fields in a single request. No scraping infrastructure to build or maintain.
Example Request
curl -H "x-api-key: YOUR_API_KEY" \
"https://www.socialcrawl.dev/v1/yelp/search?query=Pizza&location=New+York%2C+NY"import requests
response = requests.get(
"https://www.socialcrawl.dev/v1/yelp/search",
params={
'query': 'Pizza',
'location': 'New York, NY',
},
headers={"x-api-key": "YOUR_API_KEY"},
)
data = response.json()const response = await fetch(
"https://www.socialcrawl.dev/v1/yelp/search?query=Pizza&location=New+York%2C+NY",
{
headers: { "x-api-key": "YOUR_API_KEY" },
},
);
const data = await response.json();Parameters
| Parameter | Required | Description |
|---|---|---|
| query | Yes | Search term as typed on Yelp, for example Pizza or coffee. |
| location | Yes | City or full location string, for example New York, NY or San Francisco, CA, United States. Required with query. |
| cursor | No | Cursor from the previous page's next_cursor. Omit on page 1. Pages hold 10 regular businesses (plus any sponsored ones when ads=true); the cursor is a numeric offset such as 10. |
| sort | No | Result order. Only recommended (the default, Yelp's recommended order) is served. rating and review_count are refused with a free 400: no source can order Yelp search by them. To rank by rating or review count, sort the returned items by place.rating.value or place.reviews_count yourself. (recommended | rating | review_count) |
| ads | No | When true, sponsored businesses are added after the page's regular results. They are not marked as sponsored. Default false. |
What does the Yelp Search API return?
Every response follows one unified schema. Here is a real, unmodified response body, so you can see the exact fields you get back before spending a credit.
Example response
{
"success": true,
"platform": "target",
"endpoint": "/v1/target/stores",
"data": {
"items": [
{
"place": {
"id": "3412",
"name": "Chelsea 23rd and 8th",
"url": null,
"category": null,
"rating": {
"value": null,
"max": null
},
"reviews_count": null,
"price_level": null,
"address": "258 8th Ave, New York, NY 10011-1619",
"phone": "646-720-0024",
"latitude": null,
"longitude": null,
"verified": null,
"description": null,
"image_urls": null,
"ext": {
"distance": 0.37,
"status": "Open",
"timezone": "America/New_York",
"hours": [
{
"date": "2026-09-16",
"day_name": "Wednesday",
"is_open": true,
"opens_at": "08:00:00",
"closes_at": "23:00:00"
},
{
"date": "2026-09-17",
"day_name": "Thursday",
"is_open": true,
"opens_at": "08:00:00",
"closes_at": "23:00:00"
}
]
}
}
},
{
"place": {
"id": "3277",
"name": "Manhattan Herald Square",
"url": null,
"category": null,
"rating": {
"value": null,
"max": null
},
"reviews_count": null,
"price_level": null,
"address": "112 W 34th St, New York, NY 10120-0101",
"phone": "646-968-4739",
"latitude": null,
"longitude": null,
"verified": null,
"description": null,
"image_urls": null,
"ext": {
"distance": 0.42,
"status": "Open",
"timezone": "America/New_York",
"hours": [
{
"date": "2026-09-16",
"day_name": "Wednesday",
"is_open": true,
"opens_at": "08:00:00",
"closes_at": "23:00:00"
},
{
"date": "2026-09-17",
"day_name": "Thursday",
"is_open": true,
"opens_at": "08:00:00",
"closes_at": "23:00:00"
}
]
}
}
}
],
"total": 20,
"dropped": 0
},
"credits_used": 1,
"request_id": "req_example000000",
"cached": false,
"pagination": {
"next_cursor": null,
"has_more": false,
"page_size": 20
},
"credits_remaining": 9999,
"redacted": true
}Example captured from the Target API. Every SocialCrawl endpoint returns this same unified schema, so your Yelp Search response has the same fields.
How does the Yelp Search API work?
Send a GET request with your API key and get back clean, structured JSON in our unified schema. Supported computed fields are populated when the source provides the required inputs.
Method
GET
Response
JSON
How do you scrape social media data in seconds?
The fastest social media scraping API for developers. Scrape profiles, posts, comments, and analytics from 68 platforms covering 10B+ monthly active users.
One schema, every platform
Query 68 platforms with identical response structures. Write your integration once.
Computed fields, not just scraped
When an endpoint supports these metrics and the source provides the required inputs, the normalized record includes engagement_rate, estimated_reach, content_category, and language. Ready to use.
See your data before you code
Visual Data Explorer. Paste any URL, get rich result cards, sortable tables, CSV export.
import requests
response = requests.get(
'https://www.socialcrawl.dev/v1/tiktok/profile',
params={'handle': 'charlidamelio'},
headers={'x-api-key': 'sc_YOUR_API_KEY'}
)
data = response.json(){
"success": true,
"platform": "tiktok",
"data": {
"author": {
"username": "charlidamelio",
"followers": 152400000
},
"engagement": {
"likes": 12400000000,
"engagement_rate": 0.087
},
"metadata": {
"language": "en",
"content_category": "lifestyle"
}
}
}Ready to scrape Yelp Search data?
Get your API key and start pulling Yelp data in under 60 seconds.