# Grubhub API

> Grubhub restaurant menus with choice categories and single-item options

- Vendor: `grubhubapi` · version 1.0 · category Food · tags grubhub api, grubhub menu api, grubhub restaurant api, food delivery api, restaurant menu api, grubhub customizations api
- Datasource: custom HTTP routes
- Marketplace page: https://apiclay.com/api/grubhubapi
- This document: https://apiclay.com/docs/grubhubapi.md
- OpenAPI 3.1: https://apiclay.com/api/grubhubapi/openapi.json
- MCP: connect https://api.apiclay.com/v1/mcp (see https://apiclay.com/llms.txt), then `apiclay_describe_api` with vendor `grubhubapi`
- Updated: 2026-11-09

## About

## Grubhub API

Read a Grubhub restaurant's full menu with choice categories (item options) in one call, or the options of a single menu item.

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

Typical flow: `/menus` -&gt; `/customizations`

### Routes

#### GET `/menus` - Menus (restaurant menu with options)
Returns the restaurant with its full menu and option groups.

| Param | In | Type | Required | Description |
|---|---|---|---|---|
| restaurant_id | path | string | yes | Grubhub restaurant id, the number at the end of a grubhub.com restaurant link, e.g. `2114968`. |
| locationMode | query | string | yes | `pickup` or `delivery`. |
| location | query | string | no | Customer point as `POINT( )`, e.g. `POINT(-71.06356812 42.36076736)`. |
| time | query | string | no | Order time in milliseconds since the epoch; the menu reflects what is available then. |
| hideUnavailableMenuItems | query | boolean | no | `true` hides unavailable items; `false` with a `time` inside opening hours shows the menu of a closed restaurant. |

Returns (fields in the upstream response, as MealMe's parser reads them):
- `restaurant.menu_category_list[]`: categories (`id`, `name`)
- `...menu_item_list[]`: items (`id`, `name`, `description`, `price.amount`, `pickup_price.amount`, `delivery_price.amount` in cents, `media_image`, `available`)
- `...menu_item_list[].choice_category_list[]`: option groups (`id`, `name`, `min_choice_options`, `max_choice_options`, `choice_option_list[]` with `id`, `description`, `price.amount`)
- `restaurant.special_instructions_disabled`: whether item notes are allowed
- `restaurant_availability.available_hours`, `.time_zone_id`: opening hours

#### GET `/customizations` - Customizations (item options)
Returns one menu item with its option groups.

| Param | In | Type | Required | Description |
|---|---|---|---|---|
| restaurant_id | path | string | yes | Restaurant id, e.g. `2114968`. |
| item_id | path | string | yes | Item `id` from `/menus`, e.g. `268297844737`. |
| location | query | string | no | Customer point as `POINT( )`. |
| time | query | string | no | Order time in milliseconds since the epoch. |

Returns (fields in the upstream response, as MealMe's parser reads them):
- the item (`id`, `name`, `description`, `price.amount`) with its `choice_category_list[]` option groups (same shape as in `/menus`)

### Caveats

- The source site uses bot protection (not identified; MealMe calls these endpoints with Chrome TLS impersonation and rotating proxies); calls may be blocked until that is handled.
- These routes were written from MealMe's integration code and have not yet returned live data through this listing.
- The API needs an anonymous guest token. The gateway first opens a grubhub.com restaurant page as a guest and reuses the token that page sends; you do not send any token.
- Upstream calls change over time (embedded keys, field names). Verify responses before relying on them.
- Not affiliated with grubhub.com.

## Pricing

- Pay as you go: 0.01 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 (restaurant menu with options)
- Gateway: `GET https://api.apiclay.com/v1/api/grubhubapi/menus`
- Public query params: `hideUnavailableMenuItems` (boolean), `location` (string), `time` (string), `locationMode` (string, required), `restaurant_id` (string, required)
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 10 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.

### GET /customizations — Customizations (item options)
- Gateway: `GET https://api.apiclay.com/v1/api/grubhubapi/customizations`
- Public query params: `time` (string), `location` (string), `restaurant_id` (string, required), `item_id` (string, required)
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 10 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/grubhubapi/menus?locationMode=<locationMode>&restaurant_id=<restaurant_id>" \
  -H "token: <YOUR_APICLAY_TOKEN>"
```

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