Publix API
Publix data as structured JSON for the store you pick: this week's weekly ad and BOGO list, Extra Savings price reductions, digital coupons and the Pub Sub and deli menu with that store's prices; product search with the aisle, categories and nutrition facts; and a store locator with each store's weekly ad start day.
50 free credits on signup. No card, no Publix account.
{ "data": { "query": "chicken", "corrected_query": null, "store": { "id": 1614, "name": "3 Miami Central" }, "total": 249, "page": 1, "page_size": 48, "total_pages": 6, "count": 48, "sort": "relevance", "applied_filters": {}, "items": [ { "item_code": 96215, "base_product_id": "RIO-PCI-119468", "title": "Publix Boneless Skinless Chicken Breast, USDA Grade a, 97% Fat Free Less Than 4 Lbs.", "brand": "Publix", "size": null, "description": null, "image": "https://images.publixcdn.com/pct/images/products/95000/096215-600x600-A.jpg", "url": "https://www.publix.com/pd/publix-boneless-skinless-chicken-breast-usda-grade-a-97-fat-free-less-than-4-lbs/RIO-PCI-119468", "category_path": [ "Meat/Chicken" ], "aisle": "Meat", "on_sale": false, "price": null, "price_unit": null, "bundle": null, "starting_price": null, "regular_price": null, "price_text": null, "regular_price_text": null, "promo": null, "has_coupon": false, "is_order_ahead": false }, "… 47 more (trimmed for preview)" ], "facets": [ { "name": "promoType", "label": "promoType", "values": [ { "name": "promoType", "value": "BOGO", "label": "BOGO", "count": 17 }, "… 2 more (trimmed for preview)" ] }, "… 18 more (trimmed for preview)" ], "redirected_to": null }, "response_time": 6898}Live calls against the real endpoints. 3 free runs across every tab, then it's your own key.
What is the Scavio Publix API?
The Scavio Publix API is a REST API that returns Publix data from publix.com as JSON, store by store. Its 11 POST endpoints cover the weekly ad and BOGO deals, Extra Savings, digital coupons, the order-ahead deli menu, search, categories, product nutrition, stores and suggestions. publix.com shows prices only for items on sale and order-ahead items, so other items return price null. Each call costs 1 credit.
- 11
- endpoints, all live in production
- 1
- credit per call, every endpoint
- 8
- states: FL, GA, AL, SC, NC, TN, VA, KY
The Publix data buyers actually need
What is on deal this week at the store you pick, what it costs there, and where the store is.
This week's ad and BOGO list, per store
POST /api/v1/publix/weekly-adAbout 700 deals per store. At store 1614 in Miami the 2026-11-12 to 11-18 ad held 691 items: 229 Buy 1 Get 1 FREE and 20 Buy 2 Get 1 FREE, each with its deal type parsed.
Stores and the store_id behind every price
POST /api/v1/publix/storesStores near a ZIP or in a city with hours, departments, pharmacy hours and the day each store's weekly ad starts: Thursday in Florida, Wednesday in Georgia and North Carolina.
Pub Sub and deli prices by store
POST /api/v1/publix/order-aheadThe order-ahead menu with each store's prices. The Chicken Tender Sub was $12.09 in Miami and $11.99 in Atlanta and Charlotte on 2026-11-13.
Search with sale and BOGO filters
POST /api/v1/publix/search48 items a page with the aisle at that store. on_sale and bogo narrow to the deals; savings_amount sorts the biggest savings first.
Extra Savings price reductions
POST /api/v1/publix/extra-savingsSeveral hundred temporary price reductions per store with the final price: 678 in Miami, 1,319 in Atlanta and 1,363 in Charlotte.
Digital coupons, listed
POST /api/v1/publix/couponsEvery coupon a visitor sees at a store, with value, limits, dates and terms. Nothing is clipped and no Publix account is used.
Categories and nutrition
POST /api/v1/publix/productThe 382-node category tree, any category's products at a store, and product nutrition labels, one per sub component and size for deli subs.
Savings search and suggestions
POST /api/v1/publix/savings-searchOne keyword across the weekly ad, Extra Savings and coupons: "coffee" at a Miami store found 18 deals. Plus the search box's suggestions.
All 11 Publix API endpoints
Every route is a POST, returns JSON and takes the same API key; every price endpoint takes a store_id. Credits are charged per successful call and per not-found; failed upstream calls are not charged.
| Endpoint | Returns | Credits |
|---|---|---|
Search/api/v1/publix/search | Keyword search at one store, 48 a page with seven sorts and on-sale, BOGO and brand filters: item code, title, brand, size, the aisle at that store, the price and promo where the site shows one, has_coupon, plus total and facets | 1 |
Weekly ad/api/v1/publix/weekly-ad | One store's current weekly ad, about 700 items: BOGO, Buy 2 Get 1, multi-buy, sale-price and percent-off deals with a parsed deal type, save-up-to text, valid dates and the ad's start and end date | 1 |
Order ahead menu/api/v1/publix/order-ahead | One store's deli and bakery order-ahead menu with that store's prices: Pub Subs, or every sub, platter, cake and meal, 60 a page, with lead time, serves and calories | 1 |
Extra Savings/api/v1/publix/extra-savings | One store's temporary price reductions, several hundred items with the amount saved, the final price, size and the period's dates | 1 |
Digital coupons/api/v1/publix/coupons | One store's digital coupons, about 100-130, with value, brand, limits, valid dates and terms. Listed, never clipped | 1 |
Savings search/api/v1/publix/savings-search | One keyword across a store's weekly ad, Extra Savings and digital coupons in one call, each match tagged with its saving type | 1 |
Product/api/v1/publix/product | One item by Publix item code at one store: the product card with the price when shown, promo and aisle, plus its nutrition facts labels | 1 |
Category/api/v1/publix/category | One category's products at one store by id or publix.com link, 48 a page, with the search sorts and filters | 1 |
Category tree/api/v1/publix/categories | The category tree: 16 departments and 382 nodes with id, name, url, level and children | 1 |
Store locator/api/v1/publix/stores | Stores near a ZIP or in a city, or one by number: store_id, address, 7 days of hours, departments, services, pharmacy and liquor-store hours, coordinates and the weekly ad's start day | 1 |
Search suggestions/api/v1/publix/suggestions | The search-box suggestions for a partial query: up to 10 popular searches and, with a store, 4 products | 1 |
50 free credits on signup covers 50 calls to any endpoint. See plans
Weekly ad cycles by state
Publix ads start on different days by state. Every weekly-ad answer carries its start_date and end_date, and the stores endpoint gives each store's weekly_ad_break_day.
| Store | State | Ad runs | Items | Buy 1 Get 1 FREE | Buy 2 Get 1 FREE |
|---|---|---|---|---|---|
| 1614, 3 Miami Central | FL | Thu 2026-11-12 to Wed 11-18 | 691 | 229 | 20 |
| 1825, Publix at Summerhill (Atlanta) | GA | Wed 2026-11-11 to Tue 11-17 | 738 | 239 | 20 |
| 1453, Shops at Southline (Charlotte) | NC | Wed 2026-11-11 to Tue 11-17 | 730 | 240 | 21 |
Measured through the weekly-ad endpoint on 2026-11-13. Florida ads run Thursday to Wednesday; Georgia and North Carolina ads Wednesday to Tuesday. English ad only.
The same item, priced store by store
Publix prices differ by store, so every price endpoint takes a store_id. Three stores in three states, the same day.
| Item | 1614 Miami, FL | 1825 Atlanta, GA | 1453 Charlotte, NC |
|---|---|---|---|
| Publix Chicken Tender Sub (order ahead) | $12.09 | $11.99 | $11.99 |
| Boar's Head Turkey Sub (order ahead) | $11.59 | $11.49 | $11.49 |
| Publix Whole Young Chicken (sale) | $1.69/lb, 11/12-11/18 | $1.68/lb, 11/11-11/17 | $1.68/lb, 11/11-11/17 |
| 24-Pack Michelob Ultra (weekly ad) | $25.99 | $28.49 | $23.49 |
| 12-Pack White Claw (weekly ad) | $17.99 | $15.99 | $18.99 |
| Tomatoes on the Vine (weekly ad) | $2.49 lb | $2.49 lb | $2.49 lb |
Online prices publix.com showed for each selected store on 2026-11-13. Across the three weekly ads, 15 of the 590 items they shared had different prices. Prices change weekly.
This week's BOGO list at three stores in three states
stores finds the nearest store to each ZIP; weekly-ad returns that store's ad with every deal's type, savings text and dates. The response on the right is a real capture from a Miami store.
from scavio import ScavioClient
client = ScavioClient(api_key="sk_live_your_key")
# This week's BOGO list at the nearest Publix in Miami, Atlanta and Charlotte.
for zip_code in ("33101", "30303", "28202"):
store = client.publix.stores(zip=zip_code, limit=1)["data"]["stores"][0]
ad = client.publix.weekly_ad(store_id=store["store_id"], bogo_only=True)["data"]
print(store["name"], store["weekly_ad_break_day"], ad["ad"]["start_date"], ad["count"])
for item in ad["items"][:5]:
print(" ", item["deal_type"], item["title"], item["save_up_to"]){
"data": {
"store": {
"id": 1614,
"name": "3 Miami Central"
},
"ad": {
"start_date": "2026-11-12",
"end_date": "2026-11-18"
},
"total": 691,
"count": 691,
"applied_filters": {},
"departments": [
"Adult Care",
"Air Fresheners",
"Baby Food",
"Baby Needs",
"Bakery",
"Bakeware",
"Baking Products",
"Bath",
"Bathroom Tissue",
"Batteries",
"Bread",
"Breakfast",
"Brooms & Mops",
"Butter & Margarine",
"Cake Mixes",
"Candles",
"Candy",
"Canned Fruit",
"Canned Meat/Seafood",
"Canned Vegetables",
"Cereal",
"Cheese",
"Coffee & Tea",
"Cold Beer",
"Condiments & Sauces",
"Cookies",
"Cooking & Olive Oil",
"Cough & Cold",
"Crackers",
"Cream Cheese",
"Deli",
"Deodorant",
"Desserts",
"Diapers",
"Dinners",
"Dish Detergent",
"Dried Fruit & Trail Mix",
"Eggs",
"Feminine Hygiene",
"Floral",
"Fresh Pasta",
"Frozen Food",
"Frozen Meat",
"Fruit Drinks",
"Gift Card Center",
"Hair Care",
"Household Cleaners",
"Ice Cream",
"Insecticide",
"Kitchen Utensils",
"Laundry Detergent",
"Laxatives",
"Lotions",
"Lunch Meat",
"Meat",
"Meat & Cheese Snacks",
"Medicine",
"Milk",
"Novelties",
"Nutritional Bars",
"Nuts",
"Paper Products",
"Pasta & Pasta Sauce",
"Peanut Butter & Jelly",
"Pet Food",
"Pharmacy",
"Pizza",
"Plastic Bags",
"Popcorn",
"Potato Chips",
"Potatoes",
"Produce",
"Register Area",
"Salad Dressing",
"Seafood",
"Snacks",
"Soft Drinks",
"Soup & Broth",
"Spices & Extract",
"Sponges",
"Sports Drinks",
"Stuffing/Potatoes",
"Syrup & Honey",
"Toothpaste",
"Vegetables",
"Water",
"Wine",
"Yogurt"
],
"items": [
{
"id": "9fa1fc7e-b79e-4f9b-823d-de5b74caf35b",
"item_code": 24138,
"base_product_id": "RIO-PCI-107679",
"title": "Mandarins",
"description": "3-lb bag",
"brand": "Mandarins",
"department": null,
"categories": [
"produce"
],
"savings_text": "$5.99",
"additional_savings": null,
"save_up_to": "Save Up To $1.20",
"deal_type": "price",
"price": 5.99,
"price_unit": null,
"bundle": null,
"min_quantity": null,
"fine_print": null,
"stacked_with_coupon": false,
"promotion": "Weekly Ad",
"valid_from": "2026-11-12",
"valid_to": "2026-11-18",
"image": "https://images.publixcdn.com/pct/images/products/20000/024138-600x600-A.jpg"
},
{
"id": "a714b82e-d20e-4d89-a4db-e05d8f69b06b",
"item_code": 276852,
"base_product_id": "RIO-PCI-595431",
"title": "Butterball Ground Turkey",
"description": "93% Lean, 16-oz tray",
"brand": "Butterball",
"department": null,
"categories": [
"meat"
],
"savings_text": "2 for $9.00",
"additional_savings": null,
"save_up_to": "Save Up To $6.50 on 2",
"deal_type": "multi",
"price": null,
"price_unit": null,
"bundle": {
"quantity": 2,
"price": 9
},
"min_quantity": null,
"fine_print": null,
"stacked_with_coupon": false,
"promotion": "Weekly Ad",
"valid_from": "2026-11-12",
"valid_to": "2026-11-18",
"image": "https://images.publixcdn.com/pct/images/products/275000/276852-600x600-A.jpg"
},
{
"id": "087ed7db-930c-4a49-bf50-78e6898271a1",
"item_code": 450399,
"base_product_id": "RIO-PCI-152391",
"title": "La Banderita Flour Tortillas",
"description": "Free item of equal or lesser price.\nSoft Taco, 10-ct. 16-oz bag; or Organic Soft Flour Tortillas, 6-ct. 9.5-oz bag",
"brand": "La Banderita",
"department": null,
"categories": [
"grocery",
"bogo"
],
"savings_text": "Buy 1 Get 1 FREE",
"additional_savings": null,
"save_up_to": "Save Up To $3.99",
"deal_type": "bogo",
"price": null,
"price_unit": null,
"bundle": null,
"min_quantity": null,
"fine_print": null,
"stacked_with_coupon": false,
"promotion": "Weekly Ad",
"valid_from": "2026-11-12",
"valid_to": "2026-11-18",
"image": "https://images.publixcdn.com/pct/images/products/450000/450399-600x600-A.jpg"
},
{
"id": "28bf03a8-b4a4-4aad-b50b-ddc76d4ad756",
"item_code": 23707,
"base_product_id": "RIO-PCI-107428",
"title": "Tropicana Pure Premium 100% Orange Juice",
"description": "No Pulp, Single-Serve, 11-oz cont.",
"brand": "Tropicana",
"department": null,
"categories": [
"produce"
],
"savings_text": "Buy 2 Get 1 FREE",
"additional_savings": null,
"save_up_to": "Save Up To $2.09 ON 3",
"deal_type": "b2g1",
"price": null,
"price_unit": null,
"bundle": null,
"min_quantity": null,
"fine_print": null,
"stacked_with_coupon": false,
"promotion": "Weekly Ad",
"valid_from": "2026-11-12",
"valid_to": "2026-11-18",
"image": "https://images.publixcdn.com/pct/images/products/20000/023707-600x600-A.jpg"
}
]
},
"response_time": 7326
}Why not the official Publix API?
There isn't one. Here is what Publix publishes, and where the Scavio API fits.
Publix (publix.com, corporate.publix.com)
- No public developer API, portal or key program
- Business-partner resources serve approved partners: suppliers, real estate, construction
- publix.com shows prices only for items on sale and for In-Store Pickup items
- Delivery and curbside pickup run through Instacart, at prices Publix says are higher than in store
- Its Terms of Use license the sites for personal, noncommercial use
Scavio Publix API
- One Scavio key issued at signup, 1 credit per call
- store_id on every price endpoint; each answer echoes the store it priced
- The weekly ad with every deal's type parsed: BOGO, Buy 2 Get 1, multi-buy, sale price
- Extra Savings, digital coupons (listed, never clipped) and the deli order-ahead menu with store prices
- Store locator with each store's weekly ad start day
- The same JSON envelope and key as every other Scavio platform
Publix facts from publix.com (product catalog FAQ, weekly ad FAQ, Terms of Use last updated 6/30/2025), corporate.publix.com/business and the delivery.publix.com pricing policy, read 2026-11-13. Not legal advice.
What developers build with it
Weekly BOGO list apps and newsletters
Pull each store's ad the morning it starts, filter to Buy 1 Get 1 FREE and Buy 2 Get 1 FREE, and publish the list by store or by state.
stores + weekly-adSoutheast promotion analysis for CPG brands
Track which brands run BOGO, multi-buy and Extra Savings deals, in which states and for how long, from the same week's ads at stores you pick.
weekly-ad + extra-savingsStore-to-store deal price comparison
Compare the same week's ad across stores and states: in one week Miami printed a higher BOGO save-up-to amount than Charlotte on 93 of 164 shared deals.
weekly-ad + searchDeal and coupon alerts
Watch a list of keywords across the weekly ad, Extra Savings and digital coupons at one store, and alert when a match appears.
savings-searchDeli and catering menus with prices
Show Pub Sub, platter and cake prices for the store nearest a customer, with lead times and serving sizes.
stores + order-aheadNutrition datasets
Build a table of Publix items with nutrition facts per serving, from a category or a search.
category + productShopping agents and assistants
Give an AI agent Publix as tools: find the store, read this week's BOGO list, search an item's aisle and list the coupons.
MCP + RESTStore finder
Stores near a shopper with 7 days of hours, pharmacy hours, departments, services and the Publix Liquors store next door.
storesHow to get the Publix weekly ad and BOGO list by store
- 1
Get an API key
Sign up for a Scavio account and copy your key from the dashboard. You get 50 free credits on signup, with no card and no Publix account.
- 2
Find a store
Send {"zip": "33101"} to https://api.scavio.dev/api/v1/publix/stores with an Authorization: Bearer header. Each store comes back with its store_id and weekly_ad_break_day.
- 3
Read that store's weekly ad
Send {"store_id": "1614", "bogo_only": true} to /api/v1/publix/weekly-ad for the BOGO list, or leave bogo_only out for the whole ad with its start and end date.
- 4
Add search, Extra Savings, coupons and the deli menu
Use the same store_id on search, category, extra-savings, coupons, savings-search and order-ahead. Every answer echoes the store it priced.
Publix API FAQ
Does Publix have a public API?
+
No. Publix publishes no public developer API, portal or key program. Its business-partner pages serve approved partners (suppliers, real estate, construction), not data access. The Scavio Publix API is a separate option: 11 POST endpoints on one API key, 1 credit each.
Why are some prices null?
+
Because publix.com does not show them. Publix's product catalog FAQ says "Pricing is only displayed for items currently on sale and those available for purchase through In-Store Pickup at www.publix.com". So search, category and product return price only for items on sale (weekly ad, BOGO, multi-buys, Extra Savings) and for order-ahead deli and bakery items; for everything else price is null. It is never estimated, and null does not mean the item is free or not sold. Publix Search API docs
Where do the prices come from?
+
From publix.com itself: the store-level sale, BOGO and Extra Savings prices and the order-ahead menu prices Publix shows for the store you select. They are not delivery-app prices. Publix's delivery and curbside pickup run through Instacart, and Publix's pricing policy there says "Publix delivery and curbside pickup item prices are higher than item prices in physical store locations."
Where do I get a store_id?
+
From /api/v1/publix/stores: search by ZIP, by city and state, or read one store by number, and use stores[].store_id as store_id on every price endpoint. 9999 is the site's placeholder, not a store, and is refused with a 400. An unknown store number is a charged 404. Publix Store Locator API docs
Do Publix prices differ by store?
+
Some do. On 2026-11-13 the Chicken Tender Sub was $12.09 at a Miami store and $11.99 in Atlanta and Charlotte, and the 24-pack of Michelob Ultra in the weekly ad was $25.99, $28.49 and $23.49 at the same three stores. Across those three weekly ads, 15 of the 590 shared items had different prices. Pass the store_id you care about.
When does the Publix weekly ad start?
+
It depends on the state: Florida ads run Thursday to Wednesday, Georgia and North Carolina ads Wednesday to Tuesday. Publix's weekly ad FAQ says Wednesday-to-Tuesday ads post around 12 a.m. (midnight) Eastern Time Wednesday morning. Each store's weekly_ad_break_day on the stores endpoint gives its start day, and each weekly-ad answer carries start_date and end_date. Publix Weekly Ad API docs
How do I get this week's Publix BOGO list?
+
Call /api/v1/publix/weekly-ad with a store_id and bogo_only true: it returns the Buy 1 Get 1 FREE and Buy 2 Get 1 FREE items with their savings text, save-up-to amount and valid dates. A Miami store's ad had 229 BOGO and 20 Buy 2 Get 1 items out of 691. Search with bogo true returns BOGO items with the price the site shows for them.
Can I clip Publix digital coupons?
+
No. /api/v1/publix/coupons lists the coupons a visitor sees at a store, with value, limits, dates and terms, but nothing is clipped and no Publix account is used. Personalized offers of a signed-in shopper are not available.
Can I get Pub Sub and deli prices?
+
Yes. /api/v1/publix/order-ahead returns a store's order-ahead menu with its prices: the Pub Sub menu by default, or every sub, platter, cake and meal with section all (about 1,150 items, 60 a page), with lead time, serves and calories. It is menu data only: no ordering. Publix Order Ahead API docs
Does it return UPCs?
+
No. Publix does not publish UPCs online. Items are identified by the Publix item code (item_code), which is the input of the product endpoint, plus base_product_id and the product's publix.com url.
Does it include ratings, reviews, ingredients or allergens?
+
No ratings or reviews: publix.com does not show them. The product endpoint returns nutrition facts (one label per component and size for deli subs); Publix does not publish ingredients or allergens online, so they are not returned.
How do pages and limits work?
+
Search and category return 48 items a page, up to page 100, with total and total_pages. The order-ahead menu returns 60 a page. The weekly ad, Extra Savings and coupons come back whole in one call. Stores returns up to 30 stores within up to 100 miles.
What do Publix's terms say?
+
Publix's Terms of Use (last updated 6/30/2025) license its websites and apps "for your personal, noncommercial use only" and say users agree not to "access or use the Services by means of any automated program, expert system, electronic agent or 'bot' except for general purpose search engines" or to "scrape, copy, republish, license, or sell the information or Materials on the Services". Scavio returns publicly shown deal and menu data and does not sign in to shopper accounts, clip coupons or place orders. This is not legal advice; check the current terms and your own counsel for your use case.
How much does a Publix request cost?
+
1 credit per call on every endpoint. New accounts get 50 free credits on signup, one time and with no card. Paid plans start with Hobby at $15 per month for 3,000 credits; on Growth credits cost $1 per 1,000. Failed upstream calls are not charged; a not-found (an unknown store or item code) is charged.
How fresh is the data?
+
Every request reads publix.com when you call it and carries fetched_at; nothing is cached. In our captures stores answered in about 1 second, coupons in 2, search in 7, the weekly ad in 7, product in 8 and Extra Savings in 11. Upstream checks sometimes fail; they are retried automatically, and a call that still fails is a 502 that is not charged.
Explore more of Scavio
Best Publix weekly ad and BOGO APIs
Seven options priced, plus one week's BOGOs at four stores, November 2026.
How to get Publix weekly ad data
Stores, weekly ad, BOGO list, search and coupons, step by step.
Does Publix raise prices before a BOGO?
What one week of BOGO and regular prices in three states shows.
Kroger API
Kroger, QFC and Fred Meyer prices by store, deals and coupons.
ALDI API
ALDI US store prices, stock and aisle.
Walmart API
Search, product, reviews, sellers and store-level pricing.
Target API
Search, categories, detail and reviews.
Whole Foods API
Whole Foods prices by store, sale items and store locations.
HEB API
Grocery prices by store, nutrition facts and store finder.
Publix API docs
All 11 endpoints with params and real responses.
Try the Publix API free
50 free credits on signup, no card. Your first request is a POST with a ZIP or a store_id in it.