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
True when served from shared response cache. Credits still apply (full endpoint price); Age header may be present.
Code example
curl "https://api.socialfetch.dev/v1/yelp/businesses/search?query=coffee shops&location=San Francisco, CA" \
-H "x-api-key: YOUR_API_KEY"Responses
Yelp business pages found for this query and location.