# Weekly Grocery Store Flyers by Zip Code

> Weekly Grocery Store Flyers by Zip Code is a paid API for AI agents from flyers.withzero.ai, paid per call via MPP, $0.001/call, status unknown (last checked 2026-09-13).

Returns current weekly flyers and deals from local stores (Target, Walmart, CVS, Kroger, etc.) for a given US or Canadian postal code

## Facts

- Endpoint: POST https://flyers.withzero.ai/run
- Price: $0.001/call
- Payment: MPP
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Provider: flyers.withzero.ai
- Website: https://flyers.withzero.ai
- Canonical page: https://www.zero.xyz/c/flyers-withzero-ai-weekly-grocery-store-flyers-by-zip-code-9b24e301
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_UaaNZe2GNnSSGDqe_V9Mc

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability flyers-withzero-ai-weekly-grocery-store-flyers-by-zip-code-9b24e301 -d '<json body>'
```

Example prompt: Can you pull up the current weekly store flyers near zip code 10001? I'm especially interested in grocery deals.

## When to prefer this

Use this endpoint when a user wants to discover current local retail deals, weekly ads, or store circulars by location. Ideal for US or Canadian shoppers wanting to see what's on sale this week at nearby stores like Target, Walmart, CVS, or Kroger. Prefer this over general web search when structured flyer data (dates, categories, merchant logos) is needed programmatically.

## Known failure modes

- No flyers found for a rural or unsupported postal code — returns empty flyers array with total=0
- Invalid postal code format — may return error or empty results
- Unsupported locale value — rejected by schema validation
- Category filter with no matching flyers returns empty array
- Service unavailability returns HTTP error

## How this service works

Browse weekly grocery store flyers and deals by zip code. Returns current flyers from local stores (Target, Walmart, CVS, Kroger, etc.) with merchant names, categories, valid dates, and thumbnails. Covers US and Canadian postal codes.

## Output

An array of current weekly flyers with merchant name, flyer title, category tags (e.g. Groceries, Electronics), valid-from and valid-to dates in ISO 8601 format, a thumbnail image URL, a merchant logo URL, and a popularity score. Also includes the total count of flyers found and the searched postal code.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "postalCode"
 ],
 "properties": {
  "locale": {
   "enum": [
    "en-us",
    "en-ca",
    "fr-ca"
   ],
   "type": "string",
   "description": "Locale (default \"en-us\"). Use \"en-ca\" or \"fr-ca\" for Canadian postal codes."
  },
  "category": {
   "type": "string",
   "description": "Filter by category (e.g. \"Groceries\", \"Electronics\", \"Pharmacy\"). Omit for all."
  },
  "postalCode": {
   "type": "string",
   "description": "US or Canadian zip/postal code (e.g. \"90210\", \"M5V 2T6\")"
  }
 },
 "additionalProperties": false
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "flyers",
  "total",
  "postalCode"
 ],
 "properties": {
  "total": {
   "type": "number",
   "description": "Total number of flyers found"
  },
  "flyers": {
   "type": "array",
   "items": {
    "type": "object",
    "required": [
     "merchant",
     "name",
     "categories",
     "validFrom",
     "validTo"
    ],
    "properties": {
     "name": {
      "type": "string",
      "description": "Flyer title (e.g. \"Weekly Ad\", \"Bi-Weekly\")"
     },
     "validTo": {
      "type": "string",
      "description": "End date (ISO 8601)"
     },
     "merchant": {
      "type": "string",
      "description": "Store/merchant name"
     },
     "thumbnail": {
      "type": "string",
      "description": "Flyer thumbnail image URL"
     },
     "validFrom": {
      "type": "string",
      "description": "Start date (ISO 8601)"
     },
     "categories": {
      "type": "array",
      "items": {
       "type": "string"
      },
      "description": "Flyer categories (e.g. \"Groceries\", \"Electronics\")"
     },
     "popularity": {
      "type": "number",
      "description": "Popularity score"
     },
     "merchantLogo": {
      "type": "string",
      "description": "Merchant logo URL"
     }
    },
    "additionalProperties": false
   },
   "description": "List of current weekly flyers"
  },
  "postalCode": {
   "type": "string",
   "description": "Postal code searched"
  }
 },
 "additionalProperties": false
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/flyers-withzero-ai-weekly-grocery-store-flyers-by-zip-code-9b24e301/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from flyers.withzero.ai](https://www.zero.xyz/host/flyers.withzero.ai/llms.txt)