# Perkins Restaurant API

> Perkins restaurant online ordering menus and product modifiers

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

## About

## Perkins API

Read a Perkins restaurant's online-ordering menu (categories, products, prices) and the modifier groups of any product. The site's `/api` endpoint forwards to Perkins' Olo ordering backend, so responses use Olo's menu format.

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

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

Both routes take a `path` request header that names the Olo resource. The restaurant id is Perkins' Olo restaurant id.

### Routes

#### GET `/menus` - Menus (Olo menu of a restaurant)
Returns the restaurant's menu with categories and products.

| Param | In | Type | Required | Description |
|---|---|---|---|---|
| path | header | string | yes | `menus/`, e.g. `menus/123456`. |

Returns (fields read by the source code; not yet verified live):
- `imagepath`: base URL for product images
- `categories[].id`, `.name`: category
- `categories[].products[].id`, `.name`, `.description`, `.cost`: product (price in dollars)
- `categories[].products[].sku`: product sku (MealMe uses it as the item id)
- `categories[].products[].imagefilename`, `.images[0].filename`: product image file

#### GET `/customizations` - Customizations (modifiers of a product)
Returns the modifier groups and options of one product.

| Param | In | Type | Required | Description |
|---|---|---|---|---|
| path | header | string | yes | `menus//products/`, e.g. `menus/123456/products/7890123`. |

Returns (fields read by the source code; not yet verified live):
- `modifiers[].id`, `.description`, `.minselects`, `.maxselects`: modifier group and its limits
- `modifiers[].minaggregatequantity`, `.maxaggregatequantity`: quantity limits
- `modifiers[].options[].id`, `.name`, `.cost`, `.isdefault`: options
- `modifiers[].options[].modifiers`: nested modifier groups

### 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 perkinsrestaurants.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 (Olo menu of a restaurant)
- Gateway: `GET https://api.apiclay.com/v1/api/perkinsrestaurantapi/menus`
- Public headers: `path` (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 /customizations — Customizations (modifiers of a product)
- Gateway: `GET https://api.apiclay.com/v1/api/perkinsrestaurantapi/customizations`
- Public headers: `path` (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/perkinsrestaurantapi/menus" \
  -H "token: <YOUR_APICLAY_TOKEN>" \
  -H "path: <PATH>"
```

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