Find Yelp Business Candidates by Name and Location
View all Yelp Business, Reviews & Restaurant Data endpoints →Find a small set of Yelp business candidates using the required query and location strings. query accepts a business name or keyword, with coffee as its documented default; location accepts a city, neighborhood, address or ZIP code. The optional integer limit has a documented default of 10 and allowed range of 1 to 25. A recorded HTTP 200 request for Golden Boy Pizza in San Francisco, CA with limit=3 returned an object with results containing three business locations, including two San Francisco branches. Observed business records included identifiers, aliases, ratings, phone, website and structured address data. These fields are supported by the recorded observation; the supplied static response example is an empty object and establishes no additional property names, address subfields, pagination fields or availability guarantees. The 1-to-25 range and default of 10 are documented, not independently boundary-tested. Compare branch addresses and phone details before choosing an identifier for a subsequent details, menu or reviews request. This is a candidate lookup, not an exhaustive city directory, a guaranteed exact-name match or a replacement for full business search. It accepts no category, price, distance or service filters.
API Features
Live API Demo
🔒 Sign in to try it live
Log in to call this API with your own API key. New accounts get 100 free credits — no card required.
Log in / Sign upNo active API key found. Create one in your Dashboard, then reload this page. Dashboard →
/api/project/yelp/quick-search API Response (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/yelp/quick-search?key=<API_KEY>&location=<location>&query=coffee'
Query Result
Use Cases
- Resolve a known restaurant name in a city and compare its returned address and phone before selecting an identifier for details, menu or review requests.
- Use the observed Golden Boy Pizza result as an ambiguity test that requires a branch choice when two candidates share both a name and a city.
- Seed a small operator-reviewed branch list with up to the documented 25 candidates instead of claiming exhaustive city-wide coverage.
- Reconcile a local venue record against candidate ratings, website and structured address data while sending uncertain matches for manual review.
Frequently asked questions
Which inputs are required for quick search?
query and location are required strings. query accepts a business name or keyword such as coffee; location accepts a city, neighborhood, address or ZIP code. limit is optional and must be an integer.
How many businesses can I request?
The documentation specifies limit values from 1 to 25 and a default of 10 when omitted. The successful recorded request used limit=3; the range boundaries and omitted-limit behavior were not independently tested.
Which response fields were actually observed?
The recorded response was an object with results containing business records with identifiers, aliases, ratings, phone, website and structured addresses. The separate static response example is empty, so it adds no verified field names or address subfields. Presence in this observation does not guarantee that every business has every value.
Can the same business name identify multiple branches?
Yes. The Golden Boy Pizza request with location San Francisco, CA returned three locations, including two San Francisco branches. Require a branch choice based on the returned address and other identifying details rather than automatically selecting the first result.
Can I use a returned identifier for more business data?
Use the selected business identifier as the starting point for a separate details, menu or reviews lookup, following that operation's input requirements. Confirm the intended branch first; menu availability and complete review history are not guaranteed.
Does quick search support category or distance filters?
No. Its only parameters are limit, location and query. Options described by the search-filters endpoint cannot be passed to quick search.
Is this an exhaustive business directory or an exact-match resolver?
No. It returns a limited set of candidates for a name or keyword and location. Review the returned identities and addresses; do not assume all local businesses are included or that the first candidate is the intended branch.