Albertsons APIalbertsons.com ↗
Access Albertsons weekly ad deals, discounted products with pricing, and search autocomplete suggestions by store location or zip code.
What is the Albertsons API?
This API exposes 3 endpoints for accessing Albertsons grocery store weekly ad data and product search. Use get_weekly_ads to retrieve all active flyer publications for a given store location, get_weekly_ad_products to pull every discounted item from a specific publication — including sale prices, BOGO and multi-buy deal descriptions, brand names, and categories — and search_suggestions to fetch up to 20 autocomplete results for any product query.
curl -X GET 'https://api.parse.bot/scraper/81605bed-6622-4070-865a-6230c00c3748/get_weekly_ads?store_code=177&postal_code=83713' \ -H 'X-API-Key: $PARSE_API_KEY'
Get list of current weekly ad publications (flyers) for a given Albertsons store location. Returns all active weekly ads including the main Weekly Ad, Bonus Online Savings, Big Book of Savings, etc. Location is resolved from store_code when supplied (postal_code is then passed along but does not independently change results); when only postal_code is supplied, the ad provider picks the Albertsons store serving that postal code; when neither is supplied, a fixed default Idaho location (postal code 83713, store 177) is used. Only Albertsons-banner stores are covered: a store_code the site does not recognize as an Albertsons store (for example a code from a sister banner such as Jewel-Osco) returns a 422 stale_input error, and a postal code with no Albertsons store nearby returns an empty ads list with total_ads 0. One round trip.
| Param | Type | Description |
|---|---|---|
| store_code | string | Albertsons store ID number. When supplied it determines which ads are returned. A store_code the site does not recognize as an Albertsons-banner store yields a 422 stale_input (input_not_found) error. Omit it to resolve the location from postal_code alone. |
| postal_code | string | US postal/zip code (5 digits) for the store location. Used on its own to resolve the nearest Albertsons store when store_code is omitted; when store_code is set, postal_code does not independently change results. |
{
"type": "object",
"fields": {
"ads": "array of ad objects with id, name, description, valid_from, valid_to, total_pages, postal_code, validity_text, thumbnail_url, flyer_type, merchant_name",
"total_ads": "integer count of active ads",
"store_code": "string store ID used, or null when the location was resolved from postal_code alone",
"postal_code": "string postal code used, or null when only store_code was supplied"
}
}About the Albertsons API
Weekly Ad Publications
The get_weekly_ads endpoint returns all active flyer publications for a store location, identified by either store_code (an Albertsons store ID) or postal_code. When both are provided, store_code takes precedence. Each ad object in the ads array includes fields like id, name, description, valid_from, valid_to, total_pages, validity_text, and thumbnail_url. Publications returned can include the main Weekly Ad, Bonus Online Savings, Big Book of Savings, and others depending on the location. The total_ads field gives a count of active ads at that location.
Discounted Products from a Weekly Ad
The get_weekly_ad_products endpoint accepts a publication_id from the ads[*].id field returned by get_weekly_ads. If no publication_id is supplied, the endpoint falls back to fetching the main weekly ad for the location specified via store_code or postal_code. Each product object in the products array includes id, name, brand, description, sale_story, pre_price_text, price_text, post_price_text, and original_price. The optional category parameter filters results by category name using a case-insensitive partial match; verified category names include Fruits & Vegetables and similar department labels.
Search Autocomplete
The search_suggestions endpoint takes a single required query string — such as "milk", "chicken", or "bread" — and returns up to 20 suggestion objects. Each suggestion carries a query, display_query, and optionally departments and brands arrays for filtering context. The first suggestion in the list typically contains these department and brand metadata fields; the remaining suggestions carry only query text. The total_suggestions field reflects how many results were returned.
The Albertsons API is a managed, monitored endpoint for albertsons.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when albertsons.com changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official albertsons.com API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Build a weekly grocery deal tracker that surfaces current Albertsons promotions by zip code using get_weekly_ads and get_weekly_ad_products.
- Power a price comparison tool by pulling sale_story, price_text, and original_price fields from weekly ad products across multiple store locations.
- Filter discounted produce using the category parameter on get_weekly_ad_products to show only Fruits & Vegetables deals.
- Implement a grocery search bar with autocomplete backed by search_suggestions, including department and brand filter metadata from the first suggestion.
- Send automated weekly deal digests by scheduling get_weekly_ad_products calls and comparing valid_from and valid_to dates across publications.
- Identify BOGO and multi-buy deals programmatically by parsing the sale_story and description fields from the products array.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 200 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
| Team | $300/mo | 20,000 | 300 req/min |
| Company | $1,000/mo | 100,000 | 500 req/min |
Each endpoint has a fixed posted price per successful call — most fall between 1 and 10 credits — shown on this API's page before you run it. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.