Suggest Yelp locations from a partial place name
View all Yelp Business, Reviews & Restaurant Data endpoints →Request location suggestions with the required query string containing a partial place name, such as Beverly Hills. The documented suggestion scope includes cities, neighborhoods and regions. This is a geography suggestion lookup, not a business-name search, business match, address validator or geographic-boundary lookup. No probe response is available for this endpoint, and its provided HTTP 200 source example is an empty object. The documentation describes location suggestions but does not establish exact response keys, list nesting, suggestion types, ranking, identifiers, coordinates, result limits or pagination. Do not assume those fields exist. Use the suggestions to help a person choose a location label before a separate business lookup or geography review. Keep the original query alongside the selected suggestion when traceability matters. No documented guarantee makes a suggestion directly usable as a Yelp Events city slug, and a suggested location does not prove a business exists there.
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/location-autocomplete API Response (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/yelp/location-autocomplete?key=<API_KEY>&query=Beverly+Hills'
Query Result
Use Cases
- Offer location suggestions in a restaurant lookup form before a separate name-and-location request, making clear that choosing a place has not matched a business.
- Normalize analyst-entered geography labels for a branch-audit queue while preserving both the original query and the selected suggestion for review.
- Let an editor compare city, neighborhood and region suggestions when labeling a local guide, without inferring map boundaries or coordinates from the label.
- Add a human-reviewed geography selection step to a multi-location research intake before building business-specific lookup requests.
Frequently asked questions
What should I put in query?
Supply a partial place name as a required string. Beverly Hills is the documented example. The request contract does not define a minimum character count or an additional country filter.
Does this return businesses or location suggestions?
It is documented to suggest places, including cities, neighborhoods and regions. A suggestion is not a business match and does not establish that a particular restaurant or branch exists there.
Are coordinates, boundaries or address validation included?
They are not established by the available evidence. No probe response is available and the supplied HTTP 200 source example is an empty object, so exact keys, coordinates, boundaries and validation status must not be assumed.
Can I pass a suggestion directly to the events search city parameter?
Not without checking it. Events search requires a Yelp Events city slug or events URL, while this endpoint's response identifiers and formats are unverified. A suggested place label is not documented as an events city slug.
How many suggestions are returned, and can I page through them?
The supplied documentation does not establish a suggestion count, ranking guarantee or pagination fields. query is the only documented request parameter, and the empty example does not verify a result-list structure.