Skip to main content
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 under params. Only the keys below are accepted; any other key returns 422 invalid_params.
string[]
Yelp business page URL to fetch (e.g. https://www.yelp.com/biz/molinari-delicatessen-san-francisco).
string
City, region, or address to search within (e.g. β€œSan Francisco, CA”). Used with Keyword.Use together with keyword.
string
What to search for in the location: a plain term, not a URL (e.g. coffee, restaurants, plumbers, dentist).Use together with location.
string
default:"recommended"
Search result ordering.Allowed values: recommended (Recommended), rating (Highest Rated), review_count (Most Reviewed).
string[]
Search filter: restrict to price bands $ to $$$$.Allowed values: 1 ($), 2 ($$), 3 ($$$), 4 ($$$$).
string[]
Search filter: restrict to businesses with these features (e.g. Wheelchair Accessible, Dogs Allowed, Free WiFi).
integer
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 in data is one businesse, keyed by these fields.

Example response

Abridged: long text and lists are shortened.
For individual review text use yelp/reviews.