albertsons.com APIwww.albertsons.com ↗
Access Albertsons weekly ad deals, discounted products with pricing, and search autocomplete suggestions by store location or zip code.
curl -X GET 'https://api.parse.bot/scraper/81605bed-6622-4070-865a-6230c00c3748/get_weekly_ads' \ -H 'X-API-Key: $PARSE_API_KEY'
Get list of current weekly ad publications (flyers) for a given store location. Returns all active weekly ads including the main Weekly Ad, Bonus Online Savings, Big Book of Savings, etc. The store_code takes precedence over postal_code when both are provided.
| Param | Type | Description |
|---|---|---|
| store_code | string | Albertsons store ID number. Takes precedence over postal_code for determining which ads to return. Invalid store codes result in an upstream 422 error. |
| postal_code | string | US postal/zip code for the store location. Used alongside store_code; 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",
"postal_code": "string postal code used"
},
"sample": {
"data": {
"ads": [
{
"id": 7897571,
"name": "Weekly Ad",
"valid_to": "2026-05-05T23:59:59-04:00",
"flyer_type": "albertsonsintermountain",
"valid_from": "2026-04-29T00:00:00-04:00",
"description": "MA01",
"postal_code": "83713",
"total_pages": 7,
"merchant_name": "Albertsons",
"thumbnail_url": "https://f.wishabi.net/flyers/7897571/first_page_thumbnail_400w/1776817194.jpg",
"validity_text": "This Week Only"
}
],
"total_ads": 4,
"store_code": "177",
"postal_code": "83713"
},
"status": "success"
}
}About the albertsons.com 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.
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.
- 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 | 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.