# Uber Eats API

> Uber Eats store menus, grocery aisles and products, and menu item options

- Vendor: `ubereatsapi` · version 1.0 · category Food · tags uber eats api, ubereats api, uber eats menu api, food delivery api, uber eats grocery api, restaurant menu api, menu item options api, delivery menu data api
- Datasource: custom HTTP routes
- Marketplace page: https://apiclay.com/api/ubereatsapi
- This document: https://apiclay.com/docs/ubereatsapi.md
- OpenAPI 3.1: https://apiclay.com/api/ubereatsapi/openapi.json
- MCP: connect https://api.apiclay.com/v1/mcp (see https://apiclay.com/llms.txt), then `apiclay_describe_api` with vendor `ubereatsapi`
- Updated: 2026-11-18

## About

## Uber Eats API

Read the menu of any Uber Eats store, restaurant or grocery: sections, categories, items with prices and images. For grocery stores, walk the aisles with `/categories` and page through products with `/products`. For any menu item, `/customizations` returns its option groups (sizes, sides, add-ons) with prices.

Data comes from **ubereats.com** (https://www.ubereats.com). Every route below calls the site's own endpoint directly and returns the upstream response unchanged. 

Typical flow (restaurants): `/menus` -&gt; `/customizations`
Typical flow (grocery): `/menus` -&gt; `/categories` -&gt; `/products` -&gt; `/customizations`

The store uuid is a standard UUID (e.g. `3f6d47fc-b7f7-49ed-b04a-68c61dfa0571`, a McDonald's in San Francisco). In a store URL it usually appears at the end as 22 characters of URL-safe base64: `.../store//P21H_Lf3Se2wSmjGHfoFcQ` decodes to `3f6d47fc-b7f7-49ed-b04a-68c61dfa0571`.

### Routes

#### GET `/menus` - Menus (store menu, restaurant or grocery)
Returns the store's details and full menu.

| Param | In | Type | Required | Description |
|---|---|---|---|---|
| store_uuid | path | string | yes | Store uuid, e.g. `3f6d47fc-b7f7-49ed-b04a-68c61dfa0571`. |
| diningMode | query | string | yes | `DELIVERY` or `PICKUP`. |
| x-uber-device-location-latitude | header | string | no | Customer latitude, e.g. `37.7749`. |
| x-uber-device-location-longitude | header | string | no | Customer longitude, e.g. `-122.4194`. |
| x-uber-target-location-latitude | header | string | no | Delivery latitude (same as above). |
| x-uber-target-location-longitude | header | string | no | Delivery longitude (same as above). |

Returns (fields read by the source code; not yet verified live):
- `store.sections[].uuid`, `.title`, `.isTop`, `.subsectionUuids[]`: menus (the section uuid is the `sectionUuid` for `/customizations` and `/categories`)
- `store.subsectionsMap..title`, `.itemUuids[]`: categories and their items
- `store.sectionEntitiesMap..itemsMap.`: items (`title`, `price` in cents, `imageUrl`, `isSoldOut`, `numAlcoholicItems`)
- `store.catalogSectionsMap.[].payload.standardItemsPayload`: item carousels (`title.text`, `catalogItems[]`); for grocery, `ctaUri` links to aisles
- `store.supportedDiningModes`: delivery / pickup support

#### POST `/categories` - Categories (grocery aisle subcategories)
Returns the subcategories (aisles) of one grocery section.

| Param | In | Type | Required | Description |
|---|---|---|---|---|
| storeFilters.storeUuid | body | string | yes | Store uuid. |
| storeFilters.sectionUuids | body | array | yes | One section uuid, e.g. from `/menus` `store.catalogSectionsMap` `ctaUri`. |
| storeFilters.subsectionUuids | body | array | no | `null` for the whole section. |
| storeFilters.sectionTypes | body | array | no | Section type from the aisle link (`scatsectypes`), when present. |
| storeFilters.shouldReturnSegmentedControlData | body | boolean | yes | `true` to get the subcategory list. |

Returns (fields read by the source code; not yet verified live):
- `data.segmentedControlData.segmentedControlItems[].uuid`, `.title`: subcategories (the uuid is the `subsectionUuids` value for `/products`)
- `data.catalog[].catalogSectionUUID`, `.payload.standardItemsPayload.catalogItems[]`: products shown per subcategory

#### POST `/products` - Products (grocery products of a category)
Returns the products of one grocery section or subcategory, 60 per page.

| Param | In | Type | Required | Description |
|---|---|---|---|---|
| storeFilters.storeUuid | body | string | yes | Store uuid. |
| storeFilters.sectionUuids | body | array | yes | Parent section uuid. |
| storeFilters.subsectionUuids | body | array | no | Subcategory uuid from `/categories`. |
| storeFilters.sectionTypes | body | array | no | Section type from the aisle link, when present. |
| storeFilters.shouldReturnSegmentedControlData | body | boolean | yes | `true`. |
| pagingInfo.enabled | body | boolean | yes | `false` for the first page, `true` for later pages. |
| pagingInfo.offset | body | number | no | `page * 60` for later pages, `null` for the first. |

Returns (fields read by the source code; not yet verified live):
- `data.catalog[].payload.standardItemsPayload.title.text`: subcategory title
- `data.catalog[].payload.standardItemsPayload.catalogItems[].uuid`, `.title`, `.price`, `.imageUrl`, `.isSoldOut`: products (price in cents)

#### POST `/customizations` - Customizations (options of a menu item)
Returns one item's details with its option groups.

| Param | In | Type | Required | Description |
|---|---|---|---|---|
| storeUuid | body | string | yes | Store uuid. |
| sectionUuid | body | string | yes | Menu section uuid from `/menus`. |
| menuItemUuid | body | string | yes | Item uuid from `/menus`. |

Returns (fields read by the source code; not yet verified live):
- `data.uuid`, `.title`, `.itemDescription`, `.price`, `.imageUrl`, `.isSoldOut`: item (price in cents)
- `data.customizationsList[].uuid`, `.title`, `.minPermitted`, `.maxPermitted`: option group
- `data.customizationsList[].options[].uuid`, `.title`, `.price`, `.childCustomizationList`: option and nested groups
- `data.suspendReason`, `.suspendUntil`: why and until when an item is unavailable

### Caveats

- Upstream calls change over time (embedded keys, field names). Verify responses before relying on them.
- The source site uses bot protection (Uber's own bot and rate-limit checks); calls may be blocked until that is handled.
- These routes were translated from working client code but have not yet been called through ApiClay. Expect adjustments once they are tested.
- Not affiliated with ubereats.com.

## Pricing

- Pay as you go: 0.0012 credits/request
- Trial: 1 free requests per buyer
- Billing order: trial requests -> subscribed plan requests -> pay as you go. 1 credit's USD value is shown on the marketplace page.

## HTTP routes

Only the public, buyer-facing parts of each route are listed; vendor-side credentials stay on the gateway.

### GET /menus — Menus (store menu, restaurant or grocery)
- Gateway: `GET https://api.apiclay.com/v1/api/ubereatsapi/menus`
- Public headers: `x-uber-device-location-latitude`, `x-uber-target-location-latitude`, `x-uber-target-location-longitude`, `x-uber-device-location-longitude`
- Public query params: `diningMode` (string, required), `store_uuid` (string, required)
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

### POST /categories — Categories (grocery aisle subcategories)
- Gateway: `POST https://api.apiclay.com/v1/api/ubereatsapi/categories`
- Body sample (JSON):

```json
{"storeFilters": {"storeUuid": "3f6d47fc-b7f7-49ed-b04a-68c61dfa0571", "sectionUuids": ["<section uuid from /menus>"], "subsectionUuids": null, "shouldReturnSegmentedControlData": true}}
```

- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

### POST /products — Products (grocery products of a category)
- Gateway: `POST https://api.apiclay.com/v1/api/ubereatsapi/products`
- Body sample (JSON):

```json
{"storeFilters": {"storeUuid": "3f6d47fc-b7f7-49ed-b04a-68c61dfa0571", "sectionUuids": ["<section uuid from /menus>"], "subsectionUuids": ["<subsection uuid from /categories>"], "shouldReturnSegmentedControlData": true}, "pagingInfo": {"enabled": false, "offset": null}}
```

- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

### POST /customizations — Customizations (options of a menu item)
- Gateway: `POST https://api.apiclay.com/v1/api/ubereatsapi/customizations`
- Public body fields: `storeUuid` (string, required), `sectionUuid` (string, required), `subsectionUuid` (string), `menuItemUuid` (string, required)
- Body sample (JSON):

```json
{
  "storeUuid": "<storeUuid>",
  "sectionUuid": "<sectionUuid>",
  "subsectionUuid": "<subsectionUuid>",
  "menuItemUuid": "<menuItemUuid>"
}
```

- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

## Call example

```bash
curl -X GET "https://api.apiclay.com/v1/api/ubereatsapi/menus?diningMode=<diningMode>&store_uuid=<store_uuid>" \
  -H "token: <YOUR_APICLAY_TOKEN>"
```

Index of every published API: https://apiclay.com/llms.txt
