# SkipTheDishes API

> SkipTheDishes restaurant lookup and full menus with item options

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

## About

## SkipTheDishes API

Look up a SkipTheDishes restaurant by the name part of its URL (id, hours, menu images, open state) and read its full menu: menu groups, items with prices and every option group.

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

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

The clean URL is the path of a restaurant page: `skipthedishes.com/kebob-house-shaughnessy` -&gt; `kebob-house-shaughnessy`.

### Routes

#### GET `/stores` - Stores (restaurant by clean URL)
Returns the restaurant's details, including the `id` that `/menus` needs.

| Param | In | Type | Required | Description |
|---|---|---|---|---|
| clean_url | path | string | yes | Restaurant clean URL, e.g. `kebob-house-shaughnessy`. |
| fullMenu | query | boolean | no | `true` also embeds the menu, `false` keeps the response small. |
| lat | query | number | no | Customer latitude, e.g. `49.25`. |
| long | query | number | no | Customer longitude, e.g. `-123.13`. |
| order_type | query | string | no | `DELIVERY` or `PICKUP`. |
| order_time | query | number | no | Order time as a Unix timestamp, for hours at a future time. |

Returns (fields read by the source code; not yet verified live):
- `id`: restaurant id, the `restaurant_id` for `/menus`
- `online`: whether the restaurant takes orders now
- `menu.menuGroups[].menuItems[].id`, `.mediumImageUrl`, `.available`: item images and availability
- opening hours for delivery and pickup

#### GET `/menus` - Menus (menu items with modifiers)
Returns the restaurant's menu groups with items and option groups.

| Param | In | Type | Required | Description |
|---|---|---|---|---|
| restaurant_id | path | string | yes | `id` from `/stores`. |
| order_type | query | string | no | `DELIVERY` or `PICKUP`. |
| fullMenu | query | boolean | no | `true` returns the full menu. |
| lat | query | number | no | Customer latitude. |
| long | query | number | no | Customer longitude. |

Returns (fields read by the source code; not yet verified live):
- `menuGroups[].id`, `.name`, `.allowDelivery`, `.allowPickup`: menu group
- `menuGroups[].menuItems[].id`, `.name`, `.description`, `.centsPrice`, `.available`: item (price in cents)
- `menuGroups[].menuItems[].options[].name`, `.minimum`, `.maximum`, `.maximumEach`: option group and limits
- `menuGroups[].menuItems[].options[].options[].id`, `.name`, `.centsPriceModifier`: option and its price in cents

### Caveats

- Upstream calls change over time (embedded keys, field names). Verify responses before relying on them.
- The source site uses bot protection (Cloudflare); 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 skipthedishes.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 /stores — Stores (restaurant by clean URL)
- Gateway: `GET https://api.apiclay.com/v1/api/skipthedishesapi/stores`
- Public query params: `fullMenu` (string), `lat` (string), `long` (string), `order_type` (string), `order_time` (string), `clean_url` (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.

### GET /menus — Menus (menu items with modifiers)
- Gateway: `GET https://api.apiclay.com/v1/api/skipthedishesapi/menus`
- Public query params: `order_type` (string), `fullMenu` (string), `lat` (string), `long` (string), `restaurant_id` (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.

## Call example

```bash
curl -X GET "https://api.apiclay.com/v1/api/skipthedishesapi/stores?clean_url=<clean_url>" \
  -H "token: <YOUR_APICLAY_TOKEN>"
```

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