Yelp

Search Yelp businesses

Search Yelp businesses by name, category, or location.

GET/v1/yelp/businesses/search
1credit
x-api-keystringheader

API key (`sfk_...`)

Parameters
4
querystringrequiredquery

Business name, service, or category to search for.

min 1 chars · max 200 chars

locationstringrequiredquery

City, neighbourhood, postcode or address to search near.

min 1 chars · max 200 chars

pageintegeroptionalquery

Page number, starting at 1. Each page has up to 10 businesses.

≥ 1 · ≤ 24

sortstringoptionalquery

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

Response fields
42

Endpoint-specific response payload.

dataquery
string
datalocation
string
datasort
string

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

datasource
string

`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

datatotalResults
integernullable

Total results Yelp reports for this search (Yelp shows at most 240); null for web-index results.

≥ 0

dataresolvedLocation
stringnullable

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.

databusinesses[]alias
string

Business alias from its Yelp URL.

min 2 chars · max 200 chars

databusinesses[]name
string

min 1 chars

databusinesses[]url
string
databusinesses[]ranking
integernullable

Position in Yelp's results for this search; null for web-index results.

≥ 1

databusinesses[]rating
numbernullable

≥ 0 · ≤ 5

databusinesses[]reviewCount
integernullable

≥ 0

databusinesses[]priceRange
stringnullable
databusinesses[]phone
stringnullable
databusinesses[]categories[]alias
stringnullable
databusinesses[]categories[]title
string
databusinesses[]addressline1
stringnullable
databusinesses[]addressline2
stringnullable
databusinesses[]addresscity
stringnullable
databusinesses[]addressregion
stringnullable
databusinesses[]addresspostalCode
stringnullable
databusinesses[]addresscountry
stringnullable
databusinesses[]addressformatted
stringnullable
databusinesses[]coordinateslatitude
number
databusinesses[]coordinateslongitude
number
databusinesses[]photoUrl
stringnullable
databusinesses[]isClosed
booleannullable

True when the listing is marked closed; null when not reported.

datapagepage
integer

≥ 1

datapagehasMore
boolean
datapagenextPage
integernullable

≥ 2

Metadata describing the request and billing outcome.

metarequestId
string

Unique request identifier for tracing this API call.

min 1 chars

metacreditsCharged
integer

Credits charged for this request.

≥ 0

metaversion
string

Public API version that served the response.

one of: v1

metastale
booleanoptional

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

metafetchedAt
stringoptional

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.