Skip to content
Scrappa Get API key
Uber Eats API 1 credit / request

Uber Eats Stores API Documentation

GET https://scrappa.co/api/ubereats/stores

Uber Eats Stores API Documentation 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.

Uber Eats Stores API Documentation 1 credit / request

Endpoint

Request preview
GET
https://scrappa.co/api/ubereats/stores
Auth header
x-api-key
Cost
1 credit / request
query = coffee shops lat = 10 lng = 10
Response preview
200 OK
{
    "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,
...

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.

query string Required

Cuisine, dish or restaurant name, for example pizza or sushi. Required.

Example value coffee shops
lat number Required

Latitude of the delivery address, for example 40.758.

Example value 10
lng number Required

Longitude of the delivery address, for example -73.9855.

Example value 10
market string Optional

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.

Example value US
sort string Optional

rating or delivery_time. Leave it out for the recommended order.

Example value relevance
min_rating number Optional

Number from 1 to 5, for example 4.5. Every returned store has at least this rating.

Example value 10
offset integer Optional

Start position. Use next_offset of the previous answer, or 0 for the first page.

Example value 10
page_size integer Optional

Stores per page, 1 to 20. Default 20.

Example value 10

Response Schema

Example response fields are illustrative; inspect the JSON before integrating.

Example response fields

Scan these fields before integrating.

data meta success
JSON Response
200 OK
{
    "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

Handle these documented responses before retrying or showing customer-facing failures.

422

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"
}
503

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": "Uber Eats 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.