# Uber Eats Stores API Documentation

<p><strong>Uber Eats Stores API Documentation</strong> Search Uber Eats restaurants and stores that deliver to a point. Every store has the id the store endpoint accepts unchanged, the rating as a number, the review count as text and as an approximate number, the ETA in minutes, the promotions, the open status, the coordinates and the largest image. The delivery fee is a number with its currency when Uber Eats shows a plain fee, and null otherwise; most stores show none to a guest. Review counts such as 15,000+ are approximate. A query is required: Uber Eats does not list stores without one. Page with next_offset from the previous answer; a filtered page can hold fewer than 20 stores and still have more. A minimum rating never returns a store below it or without a rating. Markets: US, CA, MX, GB, FR, DE, JP and AU. Cost: 1 credit per request, only for successful requests. Failed requests are not billed.</p>

- **Documentation:** [https://scrappa.co/docs/ubereats-api/ubereats_stores](https://scrappa.co/docs/ubereats-api/ubereats_stores)
- **API group:** Uber Eats API
- **Endpoint:** `GET https://scrappa.co/api/ubereats/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 or sushi. 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. |
| `market` | string | No | us (default), ca, mx, gb, fr, de, jp or au. Without it Scrappa picks gb, fr, de, jp or au from lat and lng and uses us otherwise. Send ca or mx for Canada or Mexico. Any other value returns 422. |
| `sort` | string | No | rating or delivery_time. Leave it out for the recommended order. |
| `min_rating` | number | No | Number from 1 to 5, for example 4.5. Every returned store has at least this rating. |
| `offset` | integer | No | Start position. Use next_offset of the previous answer, or 0 for the first page. |
| `page_size` | integer | No | Stores per page, 1 to 20. Default 20. |

## Example response

```json
{
    "data": {
        "count": 20,
        "query": "pizza",
        "market": "us",
        "offset": 0,
        "stores": [
            {
                "id": "db38db57-a971-4579-994f-c8e836ac5c06",
                "url": "https://www.ubereats.com/store/little-italy-pizza-times-square/2zjbV6lxRXmZT8joNqxcBg",
                "name": "Little Italy Pizza",
                "image": "https://tb-static.uber.com/prod/image-proc/processed_images/eb8a9c568760b17c2aa272575dc39e19/9c4d3adb393f25706b737484dc73677e.jpeg",
                "dishes": [],
                "is_new": false,
                "rating": 4.52,
                "eta_max": 29,
                "eta_min": 13,
                "is_open": true,
                "latitude": 40.7598,
                "longitude": -73.9837,
                "promotions": [
                    "20% off $20+"
                ],
                "delivery_fee": null,
                "is_orderable": true,
                "is_top_rated": false,
                "review_count_text": "1,000+",
                "review_count_approx": 1000
            },
            {
                "id": "17d03e07-66ca-460f-a290-077407cbb382",
                "url": "https://www.ubereats.com/store/joes-pizza-times-square-1435-broadway/F9A-B2bKRg-ikAd0B8uzgg",
                "name": "Joe's Pizza",
                "image": "https://tb-static.uber.com/prod/image-proc/processed_images/6f67fd8dc603a197abf91eba0288129f/fb86662148be855d931b37d6c1e5fcbe.jpeg",
                "dishes": [],
                "is_new": false,
                "rating": 4.65,
                "eta_max": 30,
                "eta_min": 30,
                "is_open": true,
                "latitude": 40.7547,
                "longitude": -73.9868,
                "promotions": [],
                "delivery_fee": {
                    "text": "$3.99 Delivery Fee",
                    "amount": 3.99,
                    "currency": "USD"
                },
                "is_orderable": true,
                "is_top_rated": false,
                "review_count_text": "15,000+",
                "review_count_approx": 15000
            }
        ],
        "currency": "USD",
        "has_more": true,
        "next_offset": 20,
        "filters_applied": {
            "sort": null,
            "min_rating": null
        }
    },
    "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)