# Anycart API

> Anycart grocery store aisles and aisle products (unverified)

- Vendor: `anycartapi` · version 1.0 · category Food · tags anycart api, anycart grocery api, anycart aisles api, grocery marketplace api, anycart products api, recipe shopping api
- Datasource: custom HTTP routes
- Marketplace page: https://apiclay.com/api/anycartapi
- This document: https://apiclay.com/docs/anycartapi.md
- OpenAPI 3.1: https://apiclay.com/api/anycartapi/openapi.json
- MCP: connect https://api.apiclay.com/v1/mcp (see https://apiclay.com/llms.txt), then `apiclay_describe_api` with vendor `anycartapi`
- Updated: 2026-11-18

## About

## Anycart API

Anycart lists partner grocery stores' aisles and products. These routes return a store's aisle sections and the priced products in an aisle.

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

Typical flow: `/menus` -&gt; `/categories` (or `/customizations`)

Stores are named `_`, e.g. `safeway_1507` (store `safeway`, id `1507`).

### Routes

#### GET `/menus` - Menus (store aisles)
The store's aisle sections.

| Param | In | Type | Required | Description |
|---|---|---|---|---|
| ppshopid | query | string | yes | Store key `_`, e.g. `safeway_1507`. |
| reqCustomizationId | query | string | yes | Store name, e.g. `safeway`. |

Returns (fields the source code reads; not yet verified live):
- `result.sections[].title`: aisle group name
- `result.sections[].exploreLinks[]`: aisles with `text` (aisle name, used as `q` below) and `overwriteImageUrl`

#### GET `/categories` - Categories (aisle products)
Priced products for an aisle.

| Param | In | Type | Required | Description |
|---|---|---|---|---|
| ppshopid | query | string | yes | Store key, e.g. `safeway_1507`. |
| q | query | string | yes | Aisle name from `/menus`, e.g. `Tomato`. |
| reqCustomizationId | query | string | yes | Store name, e.g. `safeway`. |

Returns (fields the source code reads; not yet verified live):
- `result.sections[]` with `type` = `pricedIngredient`: `category.id`, `customizedSearchSuggestion.query`
- `...pricedIngredient.convertedPricedProducts[]`: `pricedProduct.sku`, `pricedProduct.title`, `pricedProduct.price`, `pricedProduct.imageUrl`, `cartItem.totalPrice`, `priceStrategy.increment`, `priceStrategy.maxAmount`
- `result.nextUrl`: path of a follow-up page, when present

#### GET `/customizations` - Customizations (aisle products as options)
The same aisle product list, used by MealMe as the options of an aisle item.

| Param | In | Type | Required | Description |
|---|---|---|---|---|
| ppshopid | query | string | yes | Store key, e.g. `safeway_1507`. |
| q | query | string | yes | Aisle name in lowercase, e.g. `vegetables`. |
| reqCustomizationId | query | string | yes | Store name, e.g. `safeway`. |

Returns: same fields as `/categories`.

### Not yet available

| Endpoint | Why |
|---|---|
| follow-up page (`result.nextUrl`) | its path comes from the previous response; not published as a route |

### Caveats

- These routes were written from MealMe's source code and have not been tested live yet (the site blocks plain requests from the test machine).
- The source site uses bot protection (Cloudflare); calls may be blocked until that is handled.
- Upstream calls change over time (embedded keys, field names). Verify responses before relying on them.
- Not affiliated with anycart.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 aisles)
- Gateway: `GET https://api.apiclay.com/v1/api/anycartapi/menus`
- Public query params: `ppshopid` (string, required), `reqCustomizationId` (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 /categories — Categories (aisle products)
- Gateway: `GET https://api.apiclay.com/v1/api/anycartapi/categories`
- Public query params: `ppshopid` (string, required), `q` (string, required), `reqCustomizationId` (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 /customizations — Customizations (aisle products as options)
- Gateway: `GET https://api.apiclay.com/v1/api/anycartapi/customizations`
- Public query params: `ppshopid` (string, required), `q` (string, required), `reqCustomizationId` (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/anycartapi/menus?ppshopid=<ppshopid>&reqCustomizationId=<reqCustomizationId>" \
  -H "token: <YOUR_APICLAY_TOKEN>"
```

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