On this page
ShelfAtlas for meal-planning and shopping-list apps
What you can build on the catalog, what is measured today and what is not there. The numbers below are read from the live data when this page is rebuilt (at most once an hour). The general reference is on /docs.
Who this is for
The data is the weekly campaign offers printed in the Danish chains' leaflets, extracted and normalised: one price per offer, valid for a date range, at chain level and nationwide. It is not a shelf-price register. If your app suggests meals, builds a shopping list or shows what is on offer for the ingredients in it, this is the data to match against.
Coverage, live
Every chain the platform tracks, with its freshness, the number of campaign offers valid right now that an API key can see, and how many of those carry each field. A dash means the chain has no such offers at the moment, is not listed on /status, or — in the cropUrl column — is not read in crop mode, so the API returns no cut-outs for it. The same freshness rule as /status applies.
| Chain | Status | Last updated | Active offers | volumeMl | unitPrice | cropUrl | productId |
|---|---|---|---|---|---|---|---|
| Bilka | Fresh | 2026-11-21 | 2051 | 23% | 100% | 100% | 0% |
| Lidl | Fresh | 2026-11-19 | 1044 | 24% | 100% | 98% | 0% |
| Føtex | Fresh | 2026-11-21 | 1147 | 40% | 99% | 100% | 0% |
| fakta Tyskland | Fresh | 2026-11-09 | 618 | 90% | 99% | 100% | 4% |
| Scandinavian Park | Fresh | 2026-11-10 | 603 | 93% | 99% | 100% | 0% |
| Pøtzsch | Fresh | 2026-10-28 | 347 | 98% | 100% | 100% | 5% |
| Fleggaard | Fresh | 2026-11-02 | 333 | 80% | 99% | 100% | 3% |
| Rema 1000 | Fresh | 2026-11-19 | 288 | 95% | 100% | 0% | 3% |
| Kvickly | Fresh | 2026-11-04 | 248 | 8% | 100% | 100% | 0% |
| Calle | Fresh | 2026-11-02 | 192 | 76% | 97% | 100% | 4% |
| Meny | Fresh | 2026-11-18 | 170 | 79% | 94% | 100% | 2% |
| BorderShop | Fresh | 2026-11-01 | 138 | 99% | 100% | 100% | 4% |
| Løvbjerg | Fresh | 2026-10-28 | 116 | 0% | 100% | — | 0% |
| Spar | Fresh | 2026-11-18 | 108 | 82% | 94% | 100% | 2% |
| ABC Lavpris | Fresh | 2026-11-17 | 86 | 81% | 94% | 100% | 1% |
| Min Købmand | Fresh | 2026-11-18 | 73 | 82% | 97% | 100% | 3% |
| Netto | Fresh | 2026-11-21 | 27 | 22% | 100% | 100% | 0% |
| LET-KØB | Fresh | 2026-11-17 | 36 | 100% | 100% | 100% | 8% |
| SuperBrugsen | Fresh | 2026-11-01 | 10 | 10% | 100% | 100% | 0% |
| Coop 365discount | Stale | — | 0 | — | — | — | — |
| Dagli'Brugsen | Stale | — | 0 | — | — | — | — |
Fields and fill rates
The percentage columns above are the share of a chain's active campaign offers that have the field set:
volumeMl— pack size in millilitres, when it could be read from the leaflet text.unitPrice(withunitPriceUnit) — price per kg or litre, when the pack size is known.cropUrl— a cut-out image of the offer. Only chains whose leaflets are read in crop mode have it; the column is a dash (not a low number) for the other chains.productId— the link to a curated product. This is the linking rate; product linking is in progress and the figure is low for the large chains today.unitCount— always set (it defaults to 1), so it has no fill-rate column.itemKey— the offer's stable item identity: the same normalised name+size key across weeks and chains for the same item. It is what/offers/searchgroups by and what/offers/history?item_key=takes, so you can follow an item from one week's sync to the next without a product link. Always set, so it has no fill-rate column.
What is not available:
- Regular (non-campaign) shelf prices: not available
- EAN / GTIN / retailer SKU on offers: not available — the chains' leaflets carry no barcodes and the one Danish GTIN database may not be passed on to third parties. Item identity is
itemKey(always) andproductId(where a curated product exists; its EAN is onGET /products/{id}) - Store-level prices: not available — offers are chain-level, nationwide
- Online-only offers and a freshness SLA: not available — /status is the live contract
Brand is not a field of its own; it only appears inside rawName.
Freshness and sync
The pipeline runs hourly and reads a leaflet the day it is published. Offers are immutable and are never deleted, so a sync only has to ask for what is new. Remember the time of your last sync and pass it as ingested_since, one chain at a time:
curl "https://api.shelfatlas.com/api/v1/public/catalog/offers?chain_slug=netto&ingested_since=<ISO of your last sync>" \ -H "Authorization: Bearer sa_live_<your-key>"
An offer expires at its validTo. Add include_expired=true to read past offers. For history use /offers/history, /price-history and /term-history. There is no freshness SLA; /status shows the live state per chain.
One thing an ingested_since sync does not see: a product link made after the offer was ingested (a productId appearing on an offer you already hold) does not change the offer's ingestedAt, so the offer is not returned again — offers have no updated_at. If you follow products, re-fetch their offers with /offers?product_id=<uuid>; otherwise do a full chain_slug sync once a week. itemKey never changes.
History also tells you how often an item is on offer. Both /offers/history (in days) and /offers/term-history (in weeks) carry summary.offer_pattern: the share of the window on offer, how many offer periods there were, the typical length of an offer and of the gap between two, whether the item is on offer now and — if the pattern holds — roughly when the next one is due. It is null unless there are at least 3 offer periods in a window of at least 84 days (history) or 12 weeks (term-history). Ask /offers/history for days=180: our history starts 2026-04-13, so a 365-day window is diluted until April 2027. The figures are medians of the past, not a forecast, and only campaign prices count — a regular shelf price is never an offer.
Matching ingredients to offers
GET /api/v1/public/catalog/offers/search?q= matches a free-text ingredient against offer names (Danish full-text search plus trigram similarity). Add order=relevance when you match a list or a recipe: the default order is the deal score (savings and price, built for consumer apps), so without it the best deal that merely mentions your ingredient can come first. A basic item that is not on offer this week is a gap in the data, not a matching miss: the catalog only holds campaign offers. If a match is wrong, send us 10–20 bad matches; they become the test cases for better matching.
curl "https://api.shelfatlas.com/api/v1/public/catalog/offers/search?q=hakket%20oksek%C3%B8d" \ -H "Authorization: Bearer sa_live_<your-key>"
Try it with your own list
One request answers "what is on offer for these items in these chains": up to 12 items, 1–3 chains, the top three offers per item and chain. It counts as one request against your quota.
curl "https://api.shelfatlas.com/api/v1/public/catalog/offers/sample?items=mælk,æg,ris&chains=netto,rema" \
-H "Authorization: Bearer sa_live_<your-key>"
{
"ok": true,
"data": {
"generated_at": "<ISO>",
"chains": [
{ "chain_slug": "netto", "chain_name": "Netto" },
{ "chain_slug": "rema", "chain_name": "Rema 1000" }
],
"items": [{ "query": "mælk", "per_chain": { "netto": [ /* offer rows */ ] } }],
"not_on_offer": [{ "query": "ris", "chain_slug": "rema" }]
}
}Each offer is the same row /offers returns. The sample is built on the same matching as /offers/search, so move to /offers/search and /offers in production code.
A week's meal plan against two chains
The flow a meal-planning app runs, shown live: 12 Danish basics priced against Netto and Rema 1000 through the sample endpoint, read with this site's own API key when the page was last rebuilt (at most an hour ago). Per ingredient and chain you get the best-matching campaign offer — the name as printed in the leaflet, the price, the last valid day and the itemKey — or that the item is not on offer this week. The totals add one pack of each matched item at its offer price: they are the on-offer part of the plan, chain-level and campaign offers only, never a full basket price. The call is the one you can repeat with your own key:
curl "https://api.shelfatlas.com/api/v1/public/catalog/offers/sample?items=hakket%20oksek%C3%B8d,kyllingebryst,%C3%A6g,m%C3%A6lk,sm%C3%B8r,ost,pasta,ris,kartofler,l%C3%B8g,guler%C3%B8dder,tomater&chains=netto,rema" \ -H "Authorization: Bearer sa_live_<your-key>"
The sample ranks each item's offers by search relevance — the same order as /offers/search?order=relevance: the offer whose name best matches the ingredient first, not the best deal — so the first offer per item and chain is what the table shows.
| Ingredient | Netto | Rema 1000 |
|---|---|---|
| hakket oksekød | Not on offer this week | HK. OKSEKØD, 35% GRØNT 25.00 kr · valid to 2026-11-22 hk. oksekød, 35% grønt|400g |
| kyllingebryst | Not on offer this week | KYLLINGEBRYSTFILET 35.00 kr · valid to 2026-11-22 kyllingebrystfil|180g |
| æg | Not on offer this week | Not on offer this week |
| mælk | Not on offer this week | PERFEKT MED MÆLK 55.00 kr · valid to 2026-11-22 perfekt med mælk|450g |
| smør | Not on offer this week | LURPAK SMØR 12.00 kr · valid to 2026-11-22 lurpak smør|200g |
| ost | Not on offer this week | MILD OST 13% 45.00 kr · valid to 2026-11-22 mild ost 13%|467g |
| pasta | Not on offer this week | Not on offer this week |
| ris | Not on offer this week | Not on offer this week |
| kartofler | Not on offer this week | SMÅ KARTOFLER 7.00 kr · valid to 2026-11-22 små kartofl|650g |
| løg | Not on offer this week | LØG 7.00 kr · valid to 2026-11-22 løg|1000g |
| gulerødder | Not on offer this week | Not on offer this week |
| tomater | Not on offer this week | TOMATSAUCE 14.00 kr · valid to 2026-11-22 tomatsauce|400g |
| On offer this week | 0.00 kr 0 of 12 items | 200.00 kr 8 of 12 items |
Read live from the API at 2026-11-21T06:46:26.013Z.
Licence and attribution
You may display the data, derive baskets and comparisons from it, and cache responses where your use case allows. Do not misrepresent where it comes from: credit it as "data from ShelfAtlas". Do not resell or redistribute the raw data in bulk as your own catalog or data product. The data is provided as-is; the retailer's printed leaflet always prevails. The binding text is in the Acceptable Use policy and the terms of service.
Plans
| Plan | Price | Requests/month | Requests/min | Personal use only |
|---|---|---|---|---|
| Free | 0 kr/month | 1,000 | 60 | Yes |
| Hobby | 49 kr/month | 5,000 | 120 | Yes |
| Standard | 649 kr/month | 100,000 | 300 | No |
| Growth | 2499 kr/month | 500,000 | 600 | No |
| Scale | 4599 kr/month | 1,000,000 | 1200 | No |
Evaluate on Free; move to Standard when the data goes into your product. Prices carry no VAT (not VAT-registered), month to month. See pricing.