| q | No | Optional full-text search over store name, address, city, and marketplace tags, max 256 characters. | |
| lat | No | Optional latitude for radius filtering or distance sort, from -90 through 90; supply together with lon. | |
| lon | No | Optional longitude for radius filtering or distance sort, from -180 through 180; supply together with lat. | |
| tag | No | Optional single marketplace tag filter, e.g. Pizza or Grocery. Repeat via /doordash-stores/facets?facet=tags to discover the full tag set. | |
| city | No | Optional exact city filter. | |
| page | No | Offset page number, 1-based, default 1; the 10000-result window applies only to offset pagination. | |
| sort | No | Optional sort order. Allowed values: relevance, rating, distance, distance_asc. Relevance ranks text matches when q is supplied and otherwise sorts by store name. | |
| facet | Yes | Required facet to aggregate. Allowed values: country, state, city, tags, display_status, price_range, dash_pass_eligible. | |
| state | No | Optional state/region code filter, e.g. CA. | |
| cursor | No | Opaque continuation cursor returned as next_cursor. Use with pagination=cursor and the same filters and sort. | |
| country | No | Optional ISO-3166-1 alpha-2 country filter, e.g. US, CA. | |
| radius_m | No | Optional radius in meters, from 1 through 50000; requires lat and lon. | |
| max_price | No | Optional maximum price range tier, inclusive. | |
| min_price | No | Optional minimum price range tier, inclusive. | |
| page_size | No | Page size, default 20, max 100; page times page_size must not exceed 10000. | |
| min_rating | No | Optional minimum aggregate rating, from 0 through 5. Stores DoorDash reports with no rating are excluded. | |
| pagination | No | Pagination mode: offset or cursor. Cursor mode uses a point-in-time snapshot and can enumerate beyond 10,000 results. | |
| dash_pass_only | No | Optional flag; when true, keep only stores DoorDash marks DashPass eligible. | |