# Flipp Weekly Ad Deals API

> Weekly grocery and retail flyer deals near a US or Canadian postal code, with prices and stores

- Vendor: `flippweeklyaddealsapi` · version 1.0 · category Business · tags flipp api, weekly ad api, grocery deals api, flyer api, coupons api, retail prices api, sale prices api
- Datasource: custom HTTP routes
- Marketplace page: https://apiclay.com/api/flippweeklyaddealsapi
- This document: https://apiclay.com/docs/flippweeklyaddealsapi.md
- OpenAPI 3.1: https://apiclay.com/api/flippweeklyaddealsapi/openapi.json
- MCP: connect https://api.apiclay.com/v1/mcp (see https://apiclay.com/llms.txt), then `apiclay_describe_api` with vendor `flippweeklyaddealsapi`
- Updated: 2026-11-18

## About

## Flipp Weekly Ad Deals API

Item search across the weekly ads (flyers) that Flipp collects from grocery, pharmacy and retail chains: for a keyword and a postal code, the matching flyer items with store name, current and pre-sale price, sale dates, images and coupons, plus online (e-commerce) items.

Data comes from **flipp.com** (https://flipp.com). Every route calls the source's own public API and returns it unchanged.

Typical flow: `/search?q=milk&amp;postal_code=10001&amp;locale=en-us`.

### Routes

#### GET `/search` - Deal search
| Param | In | Type | Required | Description |
|---|---|---|---|---|
| q | query | string | yes | Product keyword, e.g. `milk`, `coffee`. |
| postal_code | query | string | yes | US ZIP or Canadian postal code. |
| locale | query | string | no | `en-us`, `en-ca` or `fr-ca`. |

Returns: `items[]` (flyer items: `name`, `merchant_name`, `current_price`, `pre_price_text`, `valid_from`, `valid_to`, `clean_image_url`), `ecom_items[]`, `coupons`, `merchants`.

### Caveats

- Prices come from retailers' weekly ads and change every week; responses for common words can be large.
- Upstream responses can change over time. Verify fields before relying on them.
- Not affiliated with or endorsed by flipp.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 /search — Deal search
- Gateway: `GET https://api.apiclay.com/v1/api/flippweeklyaddealsapi/search`
- Public query params: `q` (string, required), `postal_code` (string, required), `locale` (string)
- 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/flippweeklyaddealsapi/search?q=<q>&postal_code=<postal_code>" \
  -H "token: <YOUR_APICLAY_TOKEN>"
```

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