DoorDash Stores API Documentation Search DoorDash restaurants and stores that deliver to a point in the United States, Canada, Australia or New Zealand. A point elsewhere returns 422. Every store has the id the store endpoint accepts unchanged, the rating and the exact review count as numbers, the ETA in minutes, the distance in miles, the price range from 1 to 4, the cuisines, the promotions, the open status, the next open and close time as ISO 8601, the coordinates and the image. delivery_fee.text is the text a guest sees, for example a first-order offer; delivery_fee.amount is a number only for a plain fee and is null otherwise. Page with next_cursor of the previous answer. A page has up to 50 stores. The filters min_rating, price_range and open_now are applied to each page and never return a store that breaks them; a page can be empty after filtering and still have a next_cursor. The sort orders the stores of the page. Cost: 1 credit per request, only for successful requests. Failed requests are not billed.
Run this endpoint
Endpoint
Parameters
Start with the required fields, then add optional filters only when your use case needs them.
Runnable path
3 required parameters needed before sending a request.
5 optional filters available.
string
Required
Cuisine, dish or restaurant name, for example pizza. Required.
coffee shops
number
Required
Latitude of the delivery address, for example 40.758.
10
number
Required
Longitude of the delivery address, for example -73.9855.
10
string
Optional
The next_cursor of the previous answer, unchanged. Leave it out for the first page.
0
string
Optional
rating, delivery_time or distance. Orders the stores of the page. Leave it out for the recommended order.
relevance
number
Optional
Number from 1 to 5. Every returned store has at least this rating.
10
string
Optional
1 to 4, or several as 1,2. Every returned store has one of these price ranges.
example
boolean
Optional
Set to 1 to return only stores that are open now.
true
Response Schema
Example response fields are illustrative; inspect the JSON before integrating.
Example response fields
Scan these fields before integrating.
data
meta
success
{
"data": {
"count": 42,
"query": "pizza",
"stores": [
{
"id": "2389176",
"url": "https://www.doordash.com/store/2389176/",
"name": "Danny Boy's Famous Original Pizzeria",
"image": "https://img.cdn4dd.com/cdn-cgi/image/fit=contain,format=auto/https://doordash-static.s3.amazonaws.com/media/photosV2/330b1e2f-9a03-4383-a7ea-e6b0a48c1067-retina-large.jpg",
"badges": [],
"rating": 4.8,
"is_open": true,
"cuisines": [
"Italian",
"Pizzeria"
],
"latitude": 34.052762,
"longitude": -118.252359,
"promotions": [],
"eta_minutes": 35,
"price_range": 2,
"delivery_fee": {
"text": "Lower fees",
"amount": null,
"currency": "USD"
},
"review_count": 1821,
"distance_miles": 1,
"next_open_time": "2026-11-08T19:17:29Z",
"next_close_time": "2026-11-09T04:05:00Z",
"review_count_text": "(1k+)"
},
{
"id": "34038019",
"url": "https://www.doordash.com/store/34038019/",
"name": "Domino's",
"image": "https://img.cdn4dd.com/cdn-cgi/image/fit=contain,format=auto/https://doordash-static.s3.amazonaws.com/media/photosV2/3bf1fb37-b1a2-47ef-a7f7-ce17b28d93c0-npp-retina-large.jpg",
"badges": [],
"rating": 4.5,
"is_open": true,
"cuisines": [
"Pizza",
"Pizzeria"
],
"latitude": 34.045399,
"longitude": -118.256329,
"promotions": [],
"eta_minutes": 34,
"price_range": 1,
"delivery_fee": {
"text": "Lower fees",
"amount": null,
"currency": "USD"
},
"review_count": 466,
"distance_miles": 0.9,
"next_open_time": "2026-11-08T19:17:29Z",
"next_close_time": "2026-11-09T08:29:00Z",
"review_count_text": "(200+)"
}
],
"currency": "USD",
"has_more": true,
"next_cursor": "eyJvZmZzZXQiOjUwLC4uLn0",
"filters_applied": {
"sort": null,
"open_now": false,
"min_rating": null,
"price_range": []
}
},
"meta": {
"credits": 1,
"billable": true,
"endpoint_family": "stores"
},
"success": true
}Errors
Handle these documented responses before retrying or showing customer-facing failures.
Validation Error
A query parameter is missing or invalid. This response is not billable.
{
"errors": {
"lat": [
"Send the latitude of the delivery address as lat, for example 40.758."
]
},
"message": "The request validation failed"
}Upstream Unavailable
The site did not answer or sent a page Scrappa cannot read. This response is not billable. Retry in a moment.
{
"meta": {
"billable": false,
"retryable": true,
"endpoint_family": "stores"
},
"error": {
"code": "UPSTREAM_UNAVAILABLE",
"message": "DoorDash is temporarily unavailable. Please retry."
},
"success": false
}Generate Code with AI
Copy a ready-made prompt with all the endpoint details, parameters, and example responses. Paste it into ChatGPT, Claude, or any AI assistant to instantly generate working code.
Try It Live
Test this endpoint in our interactive playground with real data.