// request reference
Yelp Search parameters
Send query parameters with GET /api/yelp/search. Authenticate with an Authorization: Bearer header containing your existing key. Keep keys on your server, not in browser code.
The groups below list every request field, including compatibility restrictions. Read the extended reference for detailed types, defaults, parameter combinations and additional examples.
Business search
Search Yelp’s first-party web application with native filters.
find_descBusiness name, category, or search terms.
Example / input hint: coffee
find_locRequired Yelp search location.
Example / input hint: Austin, TX
yelp_domainSupported first-party localized Yelp hostname.
Example / input hint: www.yelp.com
lOptional Yelp-native map bounds token.
Example / input hint: g:-97.80,30.20,-97.70,30.30
cfltYelp category identifier.
Example / input hint: coffee
sortbyNative Yelp ordering.
recommended Recommendedrating Ratingreview_count Review countattrsYelp-native comma-separated attribute filters.
Example / input hint: OutdoorSeating
startOffset from 0 through 10,000.
Example / input hint: 0
// response
Work with the complete JSON response
Response groups include organic_results, ads_results, filters, related_links, search_information, pagination. Groups and fields depend on the upstream result.
The SDK examples use raise_for_error() or raiseForError() so API errors are not mistaken for successful results.