POST /v1/data/yelp/business/run
Pricing: $0.002 per businesse ($2.00 per 1,000).
Paste Yelp business page URLs, or search a location by keyword (e.g. βcoffeeβ in βSan Francisco, CAβ) with optional sort, price, and feature filters.
Ways to call it
- URL: set
urls - Search: set
location,keyword(optional:sort,priceLevels,features,limit)
Request
Send the inputs underparams. Only the keys below are accepted; any other key returns 422 invalid_params.
Yelp business page URL to fetch (e.g. https://www.yelp.com/biz/molinari-delicatessen-san-francisco).
City, region, or address to search within (e.g. βSan Francisco, CAβ). Used with Keyword.Use together with
keyword.What to search for in the location: a plain term, not a URL (e.g. coffee, restaurants, plumbers, dentist).Use together with
location.Search result ordering.Allowed values:
recommended (Recommended), rating (Highest Rated), review_count (Most Reviewed).Search filter: restrict to price bands $ to $$$$.Allowed values:
1 ($), 2 ($$), 3 ($$$), 4 ($$$$).Search filter: restrict to businesses with these features (e.g. Wheelchair Accessible, Dogs Allowed, Free WiFi).
How many businesses to return, up to 1000. Each one costs a row, so this caps the bill as well as the output. Omit for as many as match.Min
1; max 1000.Example
Response fields
Each row indata is one businesse, keyed by these fields.
Example response
Abridged: long text and lists are shortened.Related APIs
For individual review text useyelp/reviews.