Publix weekly ad and coupons
A store's current savings: weekly ad deals, digital coupons and extra savings, with search by text or category. Each saving: id, type, title, brand, department, savings, additional savings, deal info, description, fine print, final price, minimum purchase, categories, image, start and end dates. Pass next_page back as page; null on the last page.
Every response includes credits_used: the credits this call cost.
Part of the Publix API: 6 endpoints with prices, use cases and example responses.
Parameters
| name | type | description |
|---|---|---|
store_id | string | Publix store number. Example: 1651 |
type | all | weekly_ad | digital_coupon | extra_savings | Which savings. Example: weekly_ad |
q | string | Text to search the savings for. |
category | string | Category name to keep. |
page | integer | Page number. Example: 2 |
limit | integer | Savings per page (default 50, max 200). |
Every endpoint also takes fresh, raw, fields (see lean responses and caching).
Example
curl "https://api.api.sh/publix/v1/savings?store_id=1651&type=weekly_ad" \
-H "x-api-key: $APISH_KEY" import os, requests
res = requests.get(
"https://api.api.sh/publix/v1/savings",
params={"store_id": "1651", "type": "weekly_ad"},
headers={"x-api-key": os.environ["APISH_KEY"]},
timeout=120,
)
res.raise_for_status()
data = res.json() const url = new URL("https://api.api.sh/publix/v1/savings");
url.searchParams.set("store_id", "1651");
url.searchParams.set("type", "weekly_ad");
const res = await fetch(url, { headers: { "x-api-key": process.env.APISH_KEY } });
if (!res.ok) throw new Error(`${res.status} ${await res.text()}`);
const data = await res.json(); Response
A JSON object with the fields described above, plus raw (the source's own data), cached, fetched_at and credits_used. Errors return {"success": false, "error": "…"} with the HTTP status (see errors). A lookup that ran but found nothing (404) costs the price above; refused calls and errors on our side are free (what's charged).
Example response (real call, trimmed: lists cut to 2 items, long text shortened, raw left out)
{"store_id": 1651,"type": "weekly_ad","query": null,"category": null,"weekly_ad_updated": "2026-11-05T11:07:53.654Z","page": 1,"count": 50,"total": null,"items": [{"id": "959080be-0d02-4fa6-8c37-810bd5259939","type": "WeeklyAd","title": "Publix Boneless Skinless Chicken Breasts","brand": "Publix","department": "Meat","savings": "Buy 1 Get 1 FREE","additional_savings": null,"deal_info": "SAVE UP TO $5.55 LB","description": "Free item of equal or lesser price. USDA Grade A, 97% Fat-Free, 4-lbs or More pkg.","fine_print": null,"final_price": null,"minimum_purchase": null,"categories": ["meat","bogo"],"image": "https://akimages.shoplocal.com/dyn_li/368.0.90.0/Retailers/Publix/261105_Page_01_Feature_011_97428_253719_PackageShot.jpg","starts": "2026-11-05T00:00:00Z","ends": "2026-11-11T23:59:59Z","promo_group_ids": ["24156400-0","24156396-0","… 3 more"]},{"id": "d5822491-a47e-4bb4-b74f-9fdc1765f65b","type": "WeeklyAd","title": "Publix Baby Cut Carrots","brand": "Publix","department": "Produce","savings": "2 for $3.00","additional_savings": null,"deal_info": "SAVE UP TO $0.98 ON 2","description": "A Good Source of Vitamin C, 1-lb bag","fine_print": null,"final_price": null,"minimum_purchase": null,"categories": ["produce"],"image": "https://akimages.shoplocal.com/dyn_li/368.0.90.0/Retailers/Publix/261105_Page_01_Feature_02_24277_253819.jpg","starts": "2026-11-05T00:00:00Z","ends": "2026-11-11T23:59:59Z","promo_group_ids": ["24156450-0","24156446-0","… 2 more"]},"… 48 more"],"next_page": 2,"cached": false,"credits_used": 1}