Looking for the overview — what this API returns, what it costs, and a call you can run without a key? See the Auchan Polska API page →
E-commerce & Marketplaces

Auchan Polska API & Scraper

zakupy.auchan.pl is Auchan's online grocery store in Poland.

4 actionsLive JSON1,000 free credits$0.67–$1.50 / 1,000 creditsMCP-ready
Get a free keyOpen in playground

🤖 Using an AI assistant? Copy this link into ChatGPT / Claude / Cursor — it reads every endpoint and parameter instantly and tells you if this API fits your use case.

Each product carries up to four prices and the API keeps them apart: `price` is the regular price, `promo_price` the promotional price printed in red, `lowest_price_30d` the "najniższa cena z 30 dni przed obniżką" line the page prints under EU price rules, and `deposit_price` the bottle deposit. `search` returns products with those prices, unit and promo unit prices, promotion texts ("23% taniej", "Drugi 50% taniej", "4+1 za grosz"), availability, brand, pack size and seller, plus brand and promotion facets; `product` adds the label text and the EAN printed on the sheet (8 of 8 sampled). The site default area is used unless you pass latitude/longitude (a Kraków address returned the same prices for 46 of 46 shared products).

Reference

What a Auchan Polska field actually contains

Fields that read differently from how they look. Every row was measured against live responses on 2026-10-18.

FieldWhat it holds
priceThe regular price in złoty.
promo_price, promo_unit_priceThe promotional price and its unit price when a promotion lowers the price (Jacobs Cronat Gold: 29.95 promo, 35.98 regular).
lowest_price_30dThe lowest price of the last 30 days that the page prints next to a promotion ("35,98 zł - najniższa cena z 30 dni przed obniżką").
deposit_priceReturnable bottle deposit, apart from the price (beer 6-pack: 2.00 zł deposit).
gtinThe EAN printed on the product sheet ("Kod EAN"), check digit verified: 8 of 8 sampled products.
sellerThe seller the site names (Auchan Polska Sp. z o.o. on all sampled rows).

Auchan publishes no total count for a search; total is filled only when the first page is the whole answer.

Live example

Real request and response JSON

Captured from the indexed primary action, search, on .

Captured request
{
  "method": "POST",
  "url": "https://api.reefapi.com/auchan-pl/v1/search",
  "headers": {
    "x-api-key": "$REEF_KEY",
    "content-type": "application/json"
  },
  "body": {
    "query": "mleko",
    "limit": 24
  }
}
Captured response
{
  "ok": true,
  "meta": {
    "api": "auchan-pl",
    "endpoint": "search",
    "mode": "live",
    "latency_ms": 434,
    "record_count": 24,
    "bytes": 322652,
    "cache_hit": false,
    "upstream_requests": 1,
    "warnings": [
      "Unknown parameter ignored: include_pii"
    ],
    "charged_credits": 3,
    "version": "1.0.0",
    "request_id": "28d3b34b37934dfe",
    "queue_ms": 2.9,
    "fetched_at": "2026-10-18T17:44:56.134Z"
  },
  "data": {
    "products": [
      {
        "id": "00997334",
        "product_uuid": "eff636b8-c3fe-445f-8ccb-2c5cb3e49d8e",
        "title": "Mleko UHT 3.2% Łaciate 1 l",
        "brand": "Łaciate",
        "pack_size": "1L",
        "price": 3.78,
        "currency": "PLN",
        "unit_price": 3.78,
        "unit": "litre",
        "promo_price": null,
        "promo_unit_price": null,
        "lowest_price_30d": null,
        "deposit_price": null,
        "price_is_estimate": false,
        "typical_weight": null,
        "available": true,
        "max_available_quantity": null,
        "in_current_catalog": true,
        "is_new": false,
        "alcohol": false,
        "promotions": [],
        "dietary_labels": [],
        "category_path": [
          "Artykuły spożywcze",
          "Mleko, nabiał i jaja",
          "Mleko"
        ],
        "rating": null,
        "review_count": null,
        "seller": {
          "id": "1db2a849-3755-436d-9d4b-f5c09c7498e9",
          "name": "Auchan Polska Sp. z o.o."
        },
        "sponsored": false,
        "image": "https://zakupy.auchan.pl/images-v3/91f3b8f0-9eaa-434b-8554-b0f1db433c99/45f67d5a-2dac-497d-9414-9e7444c82c2e/300x300.jpg",
        "url": "https://zakupy.auchan.pl/products/00997334/details",
        "group_type": "personalized"
      },
      {
        "id": "00997333",
        "product_uuid": "0ed962e7-e2b0-4dc2-8730-bcdb8dbf396b",
        "title": "Mleko UHT 2.0% Łaciate 1 l",
        "brand": "Łaciate",
        "pack_size": "1L",
        "price": 3.78,
        "currency": "PLN",
        "unit_price": 3.78,
        "unit": "litre",
        "promo_price": null,
        "promo_unit_price": null,
        "lowest_price_30d": null,
        "deposit_price": null,
        "price_is_estimate": false,
        "typical_weight": null,
        "available": true,
        "max_available_quantity": null,
        "in_current_catalog": true,
        "is_new": false,
        "alcohol": false,
        "promotions": [],
        "dietary_labels": [],
        "category_path": [
          "Artykuły spożywcze",
          "Mleko, nabiał i jaja",
          "Mleko"
        ],
        "rating": null,
        "review_count": null,
        "seller": {
          "id": "1db2a849-3755-436d-9d4b-f5c09c7498e9",
          "name": "Auchan Polska Sp. z o.o."
        },
        "sponsored": false,
        "image": "https://zakupy.auchan.pl/images-v3/91f3b8f0-9eaa-434b-8554-b0f1db433c99/38e5307c-8333-44c8-a3e6-84e5e6121839/300x300.jpg",
        "url": "https://zakupy.auchan.pl/products/00997333/details",
        "group_type": "personalized"
      },
      {
        "id": "00781527",
        "product_uuid": "c5eab574-b42a-49c4-898f-d9282fcedb42",
        "title": "Mleko UHT 3.2% Auchan 1 l",
        "brand": "Auchan",
        "pack_size": "1L",
        "price": 2.48,
        "currency": "PLN",
        "unit_price": 2.48,
        "unit": "litre",
        "promo_price": null,
        "promo_unit_price": null,
        "lowest_price_30d": null,
        "deposit_price": null,
        "price_is_estimate": false,
        "typical_weight": null,
        "available": true,
        "max_available_quantity": null,
        "in_current_catalog": true,
        "is_new": false,
        "alcohol": false,
        "promotions": [],
        "dietary_labels": [
          "Produkt Auchan"
        ],
        "category_path": [
          "Artykuły spożywcze",
          "Mleko, nabiał i jaja",
          "Mleko"
        ],
        "rating": null,
        "review_count": null,
        "seller": {
          "id": "1db2a849-3755-436d-9d4b-f5c09c7498e9",
          "name": "Auchan Polska Sp. z o.o."
        },
        "sponsored": false,
        "image": "https://zakupy.auchan.pl/images-v3/91f3b8f0-9eaa-434b-8554-b0f1db433c99/f88308a5-4bc0-451e-93eb-d3b51e9a6a15/300x300.jpg",
        "url": "https://zakupy.auchan.pl/products/00781527/details",
        "group_type": "personalized"
      }
    ],
    "returned": 24,
    "duplicate_rows_dropped": 0,
    "sponsored_rows": 0,
    "facets": [
      {
        "id": "brands",
        "label": "brands",
        "type": "BRANDS",
        "values": [
          {
            "id": "[trimmed-depth]",
            "label": "[trimmed-depth]"
          },
          {
            "id": "[trimmed-depth]",
            "label": "[trimmed-depth]"
          },
          {
            "id": "[trimmed-depth]",
            "label": "[trimmed-depth]"
          }
        ]
      },
      {
        "id": "twojeDiety",
        "label": "Twoje diety",
        "type": "RETAILER",
        "values": [
          {
            "id": "[trimmed-depth]",
            "label": "[trimmed-depth]"
          },
          {
            "id": "[trimmed-depth]",
            "label": "[trimmed-depth]"
          },
          {
            "id": "[trimmed-depth]",
            "label": "[trimmed-depth]"
          }
        ]
      },
      {
        "id": "polecaneWSklepie",
        "label": "Polecane w sklepie",
        "type": "RETAILER",
        "values": [
          {
            "id": "[trimmed-depth]",
            "label": "[trimmed-depth]"
          },
          {
            "id": "[trimmed-depth]",
            "label": "[trimmed-depth]"
          },
          {
            "id": "[trimmed-depth]",
            "label": "[trimmed-depth]"
          }
        ]
      }
    ],
    "sort_options": [
      "favorite",
      "pricePerAscending",
      "pricePerDescending"
    ],
    "has_more": true,
    "next_cursor": "eyJ0IjoiNTdkNjBkZTgtODFhMi00N2M5LWI4MTQtMjRlMzMzNjc1ZTcyIiwiYyI6IlZJU0lUT1JJRD1kMGFwS1pUYjhjeUtPYnhwdjlQM2s0LXJaTHphaWs5bnFUZERiZUJRLUZIU1JNS2tKQ0p3NUNYMmV0SlVnTnZ4czhWVzFOVDJvdFc5RS04UjhQdGd3TUpJQ2hpZWthRktLLWRaQnc9PTsgZ2xvYmFsX3NpZD1Nd05ZajhFdExLTWhsR2ZQZllZd3dkbFhYTEVrTklINGQ0VHZvWmIzd3dHY3lEeU9VZWszc1pKQWFKX0R3ZFl3bExZZjd1blJNbDBaeDV1VWEzT1JaajJ2YjFzWTY4a2ZBdjB3TlE9PTsgQVdTQUxCPWtUdTdsTm1OZm5wTHJ2d2J6SDVZQmxXVWNwdVJiVDhsSHdsSDZLSGtyNWRTWUs3bkVyd01sWS9HZkF1S2hLenRxaUMvQXRXVDVGbDl6ZlhHS1VSWjhiYU9Oam0wUEpHUGY2RDBKNkM5clVPSEdGbEExaERaeUVZNkhOR1E7IEFXU0FMQkNPUlM9a1R1N2xObU5mbnBMcnZ3YnpINVlCbFdV",
    "total": null,
    "total_basis": "unknown (source publishes no search total)",
    "currency": "PLN",
    "location": {
      "store_defaulted": true,
      "region_name": "Discovery",
      "note": "site default region for visitors without a location"
    }
  }
}
Actions

What the Auchan Polska API does

ActionDescriptionConcrete use caseKey params
searchSearch the Auchan Polska online grocery catalogue (PLN). Auchan zakupy online, Polska; promo_price and lowest_price_30d are published by the source.Pricing teams call search to search the Auchan Polska online grocery catalogue (PLN).query
categoryBrowse one Auchan Polska category by its id from categories.Marketplace operators call category to get browse one Auchan Polska category by its id from categories..category_id
productFull Auchan Polska product sheet: description, ingredients, allergens, nutrition table, every label field, all images, promotions with terms.Catalog enrichment teams call product to get full Auchan Polska product sheet.id
categoriesAuchan Polska category tree (top level and one child level) with the ids the category action takes.Retail analysts call categories to get auchan Polska category tree (top level and one child level) with the ids the category action….none
Code samples

Call search from your stack

curl -X POST https://api.reefapi.com/auchan-pl/v1/search \
  -H "x-api-key: $REEF_KEY" \
  -H "content-type: application/json" \
  -d '{"query":"mleko","limit":24}'
MCP one-liner
Ask your MCP-connected assistant: call reefapi.auchan-pl.search with {"query":"mleko","limit":24}.
Use cases

Who uses this API and why

  • Track Auchan Poland promotions with the legally required 30-day lowest price.
  • Match Polish grocery products across retailers by EAN.
  • Monitor beverage prices including bottle deposits.
  • Compare promo depth (promo_price vs price) by category.
  • Build a Polish grocery price index with unit prices.
FAQ

Questions developers ask before integrating

Do I need an Auchan account?

No. Everything is read as a visitor before signing in.

What is lowest_price_30d?

The lowest price in the 30 days before a promotion, which Polish shops must print next to a discount. It is returned as printed, apart from the regular and promo prices.

Is there a loyalty-card price?

No member price is published on the public site.

Does on_offer work?

Yes: "ser" returned 11 products with on_offer=true, all 11 promoted, against 4 of 48 without it.

Are EAN codes included?

Yes, from the product sheet: 8 of 8 sampled sheets printed one, and each passed the check-digit test.

How many products per page?

Up to 48 (24 by default); three pages in a row returned 72 different products.

How fresh is the data?

Every call reads the site live; nothing is cached.

What is the Auchan Polska API?

Auchan Polska API is a ReefAPI endpoint group for auchan poland online groceries (zakupy.auchan.pl) as json: pln regular and promo prices, 30-day lowest price, deposit, ean, seller. It returns live JSON through POST requests under /auchan-pl/v1.

Is the Auchan Polska API free to try?

Yes. ReefAPI starts with 1,000 free credits, no card required. Auchan Polska calls use the same shared credit balance as every other ReefAPI engine.

Do I need an Auchan Polska login or account?

No login to Auchan Polska is needed for the API response. You call ReefAPI with your x-api-key header, and the playground can run live examples before you create a production key.

How fresh is the Auchan Polska data?

The page example is captured from a live search call, and production requests fetch live data through ReefAPI rather than a static sample.

How many credits does the Auchan Polska API use?

Auchan Polska actions currently cost 1-3 credits per successful call. Failed or blocked calls are free. All APIs draw from one credit pool.

Can I call Auchan Polska from an AI assistant or MCP client?

Yes. Connect ReefAPI once through MCP and your assistant can call auchan-pl actions with the same key, credit pool and JSON envelope used by normal REST requests.

Is the Auchan Polska API an Auchan Polska scraper?

It is the managed alternative to a DIY Auchan Polska scraper. Instead of building and maintaining your own scraper — proxies, headless browsers, captcha and constant breakage — you call one ReefAPI endpoint and get the same auchan poland online groceries (zakupy.auchan.pl) as json: pln regular and promo prices, 30-day lowest price, deposit, ean, seller back as clean JSON.

docs / auchan-pl

Auchan Polska

Auchan Poland online groceries (zakupy.auchan.pl) as JSON: PLN regular and promo prices, 30-day lowest price, deposit, EAN, seller.

base /auchan-pl/v14 endpoints
post/auchan-pl/v1/category3 credits

Browse one Auchan Polska category by its id from categories.

ParameterAllowed / rangeDescription
category_idrequired—Category UUID from the categories action.
limit = 24optional1–48Products requested per page, 1-48. The source can return fewer (duplicate rows across its groups are dropped).
cursoroptional—next_cursor from the previous page of the same call (same query, filters and location).
sort = favoriteoptionalfavorite · priceAscending · priceDescending · pricePerAscending · pricePerDescendingSource ordering.
brandoptional—Exact brand value from the facets[id=brands] list of a previous answer.
on_offer = falseoptional—Only products with a source promotion when true.
latitudeoptional—Delivery location latitude. Prices and assortment on Auchan Polska follow the region that serves this point; give latitude and longitude together. Without them the answer uses the site default region (Discovery) and says store_defaulted=true.
longitudeoptional—Delivery location longitude (with latitude).
postal_codeoptional—Postal code of that location (optional, passed to the site with the coordinates).
Try in playground →
post/auchan-pl/v1/product2 credits

Full Auchan Polska product sheet: description, ingredients, allergens, nutrition table, every label field, all images, promotions with terms.

ParameterAllowed / rangeDescription
idrequired—Product id from search (`id`), or a zakupy.auchan.pl product URL.
latitudeoptional—Delivery location latitude. Prices and assortment on Auchan Polska follow the region that serves this point; give latitude and longitude together. Without them the answer uses the site default region (Discovery) and says store_defaulted=true.
longitudeoptional—Delivery location longitude (with latitude).
postal_codeoptional—Postal code of that location (optional, passed to the site with the coordinates).
Try in playground →
post/auchan-pl/v1/categories1 credit

Auchan Polska category tree (top level and one child level) with the ids the category action takes.

Try in playground →
Built for volume
5M+ requests a day

Measured at 60 requests a second across the fleet, with no central bottleneck. Volume pricing is on request, and per-key limits are raised for high-volume accounts.

Missing a source?
We build it

Tell us a site we do not cover yet and it becomes an engine. A customer asked for bestprice.gr on a Sunday and it was in the catalog the next day.

Support
2 minute median reply

Median time from a question in the live chat to the first answer, measured across every answered conversation. Setup help included, no support tier to buy.

One key, one balance
Every API included

No per-site plans and no separate subscriptions. One key and one credit pool across the whole catalog, so adding a source costs nothing up front.

Planning something large? Tell us the volume and the sources and we will come back with what it costs and what we would have to build.