{"uid":"cap_UaaNZe2GNnSSGDqe_V9Mc","slug":"flyers-withzero-ai-weekly-grocery-store-flyers-by-zip-code-9b24e301","name":"Weekly Grocery Store Flyers by Zip Code","description":"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.","url":"https://flyers.withzero.ai/run","method":"POST","headers":{},"bodySchema":{"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},"responseSchema":{"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},"example":null,"exampleRequest":null,"tags":[],"displayCostAmount":"0.001","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"registry","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.001/call","primary":{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_nqeS1bsLHYnRawiJuB3uX","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x20C000000000000000000000b9537d11c60E8b50","unit":"request","depositMicros":null,"planRef":"grocery-flyers:1"}],"brandName":"flyers.withzero.ai","brandSlug":"flyers-withzero-ai-mpp","brandBaseUrl":"https://flyers.withzero.ai","brandDocsUrl":null,"whatItDoes":"Returns current weekly flyers and deals from local stores (Target, Walmart, CVS, Kroger, etc.) for a given US or Canadian postal code","exampleAgentPrompt":"Can you pull up the current weekly store flyers near zip code 10001? I'm especially interested in grocery deals.","exampleUseCases":null,"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T18:33:02.112Z","isFirstParty":true}