datasets_doordash_stores_search
Search and filter DoorDash merchant stores by text, location, tags, price, rating, or DashPass status to retrieve structured store listings.
Instructions
Search the DoorDash store directory. Searches the DoorDash merchant-location directory (dataset id doordash-stores). Identity and marketplace fields (name, marketplace tags, price range, ratings, DashPass eligibility) are available for each store; contact, address, and coordinates can be missing for a store that has not been fully processed yet. display_status, display_asap_time, asap_available, and pickup_available are a point-in-time observation of the PICKUP surface at crawl time, not a durable capability. Geographic coverage is best-effort. Supports full-text q, country/state/city/tag filters, dash_pass_only, min_price/max_price/min_rating, lat/lon/radius_m radius filtering, and sort (relevance, rating, distance, distance_asc). sort=relevance ranks by text-match score when q is supplied; without q it sorts by store name. Use pagination=cursor and the returned next_cursor to enumerate beyond the 10,000-result offset window against a point-in-time snapshot. Billing: this search costs 1 credit per record returned, with a minimum of 2 (an empty result costs 2, a full page of 100 costs 100).
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| q | No | Full-text search over store name, address, city, and marketplace tags, max 256 characters | |
| lat | No | Latitude for radius filtering or distance sort, requires lon | |
| lon | No | Longitude for radius filtering or distance sort, requires lat | |
| tag | No | Single marketplace tag filter, e.g. Pizza | |
| city | No | Exact city filter | |
| page | No | Offset page number, defaults to 1; ignored by cursor pagination except page=1 to start | |
| sort | No | Sort enum: relevance, rating, distance, distance_asc | |
| state | No | State/region code filter, e.g. CA | |
| cursor | No | Opaque continuation token returned in next_cursor; use with pagination=cursor and the same filters and sort | |
| country | No | ISO-3166-1 alpha-2 country filter, e.g. US, CA | |
| radius_m | No | Radius in meters, 1 through 50000; requires lat and lon | |
| max_price | No | Maximum price range tier, inclusive | |
| min_price | No | Minimum price range tier, inclusive | |
| page_size | No | Page size, defaults to 20 and maxes at 100; the 10,000-result cap applies only to offset pagination | |
| min_rating | No | Minimum aggregate rating, 0 through 5; excludes unrated stores | |
| pagination | No | Pagination mode: offset or cursor. Cursor mode supports full enumeration beyond the offset result window. | |
| dash_pass_only | No | Keep only DashPass-eligible stores |