Yelp Search Suggestions API
Scrape Yelp Search Suggestions data with one API call. Returns Yelp typeahead rows for a query in a location: category, common, chain, and business suggestions, each with a title, type, and optional subtitle, thumbnail, and redirect URL. Business rows carry alias URLs, which do not resolve on GET /v1/yelp/business/info. Category redirect URLs may be incomplete.
Last updated September 2026Maintained by the SocialCrawl team
Returns Yelp typeahead rows for a query in a location: category, common, chain, and business suggestions.
Use it to autocomplete a search box. Business rows carry alias URLs, which do not resolve on business/info.
Searching 61 platforms in parallel
What can you do with the Search Suggestions API?
The Search Suggestions 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/suggestions?query=Pizza&location=New+York%2C+NY"import requests
response = requests.get(
"https://www.socialcrawl.dev/v1/yelp/search/suggestions",
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/suggestions?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. |
What does the Yelp Search Suggestions 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": "google",
"endpoint": "/v1/google/search",
"data": {
"items": [
{
"title": "My Top 50 London Restaurants (26 Jan-9 Feb 2025)",
"url": "https://anguscolwell.substack.com/p/my-top-50-london-restaurants-26-jan",
"description": "Feb 9, 2025 · 1) Bouchon Racine, Farringdon. I'm completely obsessed with it, I love it more than anywhere else, it's operating on a level above any other ..."
},
{
"title": "The 38 Best London Restaurants According to Eater's Local Dining ...",
"url": "https://www.eater.com/maps/best-london-restaurants-eater-38",
"description": "The best meals in London, from Michelin fine dining to beloved street food, according to a longtime restaurant editor."
},
{
"title": "LONDON by The MICHELIN Guide",
"url": "https://guide.michelin.com/us/en/travel-guide/london",
"description": "Discover the beloved restaurants and exciting new openings that everyone is talking about: London's bustling pubs, MICHELIN-Starred restaurants that are among ..."
}
],
"dropped": 0
},
"credits_used": 1,
"credits_remaining": 9999,
"request_id": "req-8Kq2ZmR4vT9xLb3P",
"cached": false,
"pagination": {
"next_cursor": "sc.eyJ2IjoyLCJjIjoiMiIsInAiOiJwYWdlIn0",
"has_more": true,
"page_size": 10
}
}Example captured from the Google Search API. Every SocialCrawl endpoint returns this same unified schema, so your Yelp Search Suggestions response has the same fields.
How does the Yelp Search Suggestions 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 61 platforms covering 10B+ monthly active users.
One schema, every platform
Query 61 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 Suggestions data?
Get your API key and start pulling Yelp data in under 60 seconds.
