publix.com APIpublix.com ↗
Search Publix products, retrieve pricing and promotions, browse weekly ad deals, find store locations, and get category data via a structured JSON API.
curl -X POST 'https://api.parse.bot/scraper/311a0a1a-57d6-41d3-b87d-b2cc0de89ded/search_products' \
-H 'X-API-Key: $PARSE_API_KEY' \
-H 'Content-Type: application/json' \
-d '{
"limit": "3",
"query": "milk"
}'Search for products in the Publix catalog via GraphQL. Returns product listings with pricing, promotions, and basic nutritional info. Supports pagination via offset.
| Param | Type | Description |
|---|---|---|
| limit | integer | Max results to return. |
| queryrequired | string | Search keyword (e.g. 'milk', 'organic healthy snacks'). |
| offset | integer | Number of results to skip for pagination. |
| store_number | string | Publix store number for store-specific pricing. |
{
"type": "object",
"fields": {
"total": "integer total number of matching products",
"products": "array of product objects with baseProductId, itemCode, title, sizeDescription, priceLine, onSale, savingLine, imageUrls, titleBrand, fauxTaxonomy"
},
"sample": {
"data": {
"total": 167,
"products": [
{
"title": "Publix Milk, Whole",
"onSale": false,
"itemCode": 70800,
"priceLine": null,
"savingLine": null,
"titleBrand": "Publix",
"fauxTaxonomy": [
"Dairy/Milk and Milk Alternatives"
],
"baseProductId": "RIO-PCI-113569",
"sizeDescription": "1 gal (3.78L)"
}
]
},
"status": "success"
}
}About the publix.com API
The Publix API covers 7 endpoints that expose product catalog data, store locations, weekly ad deals, and search suggestions from Publix grocery stores. Use search_products to query the full catalog with pricing, sale status, and image URLs, or call get_weekly_ad to pull all active promotional deals for a specific store — including savings amounts, department tags, and promotion date ranges.
Product Search and Details
search_products accepts a keyword query plus an optional store_number and returns an array of product objects including priceLine, onSale, savingLine, sizeDescription, and imageUrls. Results are paginated via limit and offset. When you need full ingredient data, get_product_details accepts either a baseProductId or itemCode (both available from search results) and returns a ingredients field alongside priceLine, onSale, and sizeDescription. Note that ingredients may be an empty string for products where that data is unavailable.
Deals and Weekly Ads
get_weekly_ad retrieves all active weekly ad promotions for a given store_number, returning Title, Description, Savings, Department, Brand, ImageUrl, WA_StartDate, and WA_EndDate per deal. Setting page_size to 0 returns the full deal set in a single response. The specialized get_sub_sandwich_deals endpoint narrows results to sub sandwich items currently on promotion, returning priceLine, savingLine, promoMsg, and promoTotalSavings for each matching item.
Stores and Categories
find_stores takes a city name, a city, state string, or a 5-digit US zip code and returns store objects with storeNumber, address, phoneNumbers, hours, departments, services, latitude, longitude, and distance. The get_all_categories endpoint returns a flat list of category objects — each with a UUID ID, Name, and DisplayName — representing the full Publix catalog taxonomy, optionally scoped to a specific store.
Search Suggestions
get_suggestions provides typeahead support: submit a partial keyword (e.g. 'chick') and receive both TextSuggestions (string completions) and ProductSuggestions (preview objects with title, itemCode, and imageUrls). This is useful for building autocomplete interfaces or validating search terms before issuing a full search_products call.
- Track weekly Publix sale prices for specific product categories using get_weekly_ad and filtering by Department
- Build a grocery price comparison tool using priceLine and onSale fields from search_products across multiple store numbers
- Power a store locator feature by querying find_stores with zip codes and mapping results using latitude/longitude fields
- Check ingredient lists for allergen screening using the ingredients field returned by get_product_details
- Monitor sub sandwich promotions automatically with get_sub_sandwich_deals to alert users when deals go live
- Build a category-browsing UI for the Publix catalog using the UUID-keyed category tree from get_all_categories
- Implement search autocomplete using TextSuggestions and ProductSuggestions from get_suggestions
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.