Suggest Yelp Search Terms and Businesses
View all Yelp Business, Reviews & Restaurant Data endpoints →Get search suggestions for the required query, a partial search term such as piz. The optional location supplies geographic context for tailoring the suggestions. The documented suggestion types are categories, popular search phrases and matching businesses. No nonempty response was independently observed for this operation, and the supplied response example is an empty object, so suggestion property names, grouping keys and business identifier fields are not verified. Treat these suggestion types as documented capabilities rather than a confirmed response schema. Suggestions are not a complete business directory, and popular search suggestions do not establish measured search volume.
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/search-autocomplete API Response (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/yelp/search-autocomplete?key=<API_KEY>&query=piz'
Query Result
Use Cases
- Design a typeahead menu with separate category, search-phrase and business sections after confirming the actual returned structure.
- Help a local-guide editor discover suggested cuisine or service wording for a selected city without treating the wording as measured search demand.
- Offer partial-name suggestions before asking an operator to confirm the intended business branch through a separate lookup.
- Build location-specific search prompts for a travel planner while treating suggestions as a shortlist rather than an exhaustive business directory.
Frequently asked questions
Which input is required for autocomplete?
query is required and must be a string containing the partial search term, such as piz. location is optional.
Can I tailor suggestions to a city?
Yes. The documented purpose of location is to tailor suggestions to a place, for example San Francisco, CA. A nonempty response for this endpoint has not been independently verified.
What kinds of suggestions are documented?
The documentation describes categories, popular search phrases and matching businesses. These are documented suggestion types, not independently confirmed response groups.
Are the response property names known?
No response property names are established by the supplied evidence. Its response example is an empty object, and there is no recorded nonempty response for this operation. Do not assume specific grouping keys or business identifier fields.
Can a suggestion be saved as a unique business branch?
Not without confirmation. A category or search phrase is not a business, and a business name alone may not distinguish branches. Confirm the suggestion type and the intended branch before saving a business record.
Do popular suggestions report search volume?
No search-volume metric is documented or observed. Use the suggestions as wording ideas, not as evidence of traffic, demand or ranking popularity.