Search Yelp businesses
Search Yelp businesses by name, category, or location.
Headers
Get your API keyAPI key (`sfk_...`)
Business name, service, or category to search for.
min 1 chars · max 200 chars
City, neighbourhood, postcode or address to search near.
min 1 chars · max 200 chars
Page number, starting at 1. Each page has up to 10 businesses.
≥ 1 · ≤ 24
Result order. `recommended` is Yelp's default ranking. `highest_rated` and `most_reviewed` use Yelp's own sorts.
one of: recommended, highest_rated, most_reviewed
Endpoint-specific response payload.
Result order. `recommended` is Yelp's default ranking. `highest_rated` and `most_reviewed` use Yelp's own sorts.
one of: recommended, highest_rated, most_reviewed
`yelp`: Yelp's own search results with verified listing data. `web_index`: fallback from a web search index when Yelp search is unavailable; fields it cannot see are null.
one of: yelp, web_index
Total results Yelp reports for this search (Yelp shows at most 240); null for web-index results.
≥ 0
Where Yelp actually searched, as Yelp describes it (e.g. `Austin, Texas`). Check it for ambiguous place names: a bare `Glasgow` can resolve to Glasgow, Delaware; add the country to disambiguate. Null for web-index results.
Business alias from its Yelp URL.
min 2 chars · max 200 chars
min 1 chars
Position in Yelp's results for this search; null for web-index results.
≥ 1
≥ 0 · ≤ 5
≥ 0
True when the listing is marked closed; null when not reported.
≥ 1
≥ 2
Metadata describing the request and billing outcome.
Unique request identifier for tracing this API call.
min 1 chars
Credits charged for this request.
≥ 0
Public API version that served the response.
one of: v1
Present, and `true`, only when the source couldn't be reached and this is the last good answer for the same request instead, up to 24 hours old. Absent on every live answer.
one of: true
When a stale answer (`stale: true`) was originally fetched (ISO 8601, UTC). Absent on every live answer.
Code example
curl "https://api.socialfetch.dev/v1/yelp/businesses/search?query=coffee%20shops&location=San%20Francisco,%20CA" \
-H "x-api-key: YOUR_API_KEY"Responses
Yelp business pages found for this query and location.