# DoorDash Stores API Documentation

<p><strong>DoorDash Stores API Documentation</strong> 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.</p>

- **Documentation:** [https://scrappa.co/docs/doordash-api/doordash_stores](https://scrappa.co/docs/doordash-api/doordash_stores)
- **API group:** DoorDash API
- **Endpoint:** `GET https://scrappa.co/api/doordash/stores`

## Authentication

Send your Scrappa API key in the `X-API-KEY` request header. Paid endpoints also support accountless x402 payments when called without an API key.

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `query` | string | Yes | Cuisine, dish or restaurant name, for example pizza. Required. |
| `lat` | number | Yes | Latitude of the delivery address, for example 40.758. |
| `lng` | number | Yes | Longitude of the delivery address, for example -73.9855. |
| `cursor` | string | No | The next_cursor of the previous answer, unchanged. Leave it out for the first page. |
| `sort` | string | No | rating, delivery_time or distance. Orders the stores of the page. Leave it out for the recommended order. |
| `min_rating` | number | No | Number from 1 to 5. Every returned store has at least this rating. |
| `price_range` | string | No | 1 to 4, or several as 1,2. Every returned store has one of these price ranges. |
| `open_now` | boolean | No | Set to 1 to return only stores that are open now. |

## Example response

```json
{
    "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

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | A query parameter is missing or invalid. This response is not billable. |
| 503 | Upstream Unavailable | The site did not answer or sent a page Scrappa cannot read. This response is not billable. Retry in a moment. |

## More Scrappa resources

- [API documentation](https://scrappa.co/docs)
- [Full LLM-readable API reference](https://scrappa.co/llms-full.txt)
- [OpenAPI specification](https://scrappa.co/docs/api.json)
- [Pricing](https://scrappa.co/pricing)