Auchan Portugal API

Auchan Portugal prices, promotions and store prices as JSON

Auchan Portugal runs hypermarkets, supermarkets and My Auchan stores, and auchan.pt is its online shop.

no credit card1,000 free credits · instant API key · pay by card or crypto
Missing a Auchan Portugal endpoint, or need a source we don't have yet?Contact us real people · same-day reply.
A
/auchan-pt/v1

6 active endpoints, on 2 and 3 credit tiers.

  • POST/auchan-pt/v1/search
  • POST/auchan-pt/v1/category
  • POST/auchan-pt/v1/promotions
  • POST/auchan-pt/v1/product
  • POST/auchan-pt/v1/categories
  • POST/auchan-pt/v1/stores

What Auchan Portugal endpoints does ReefAPI ship?

6 live read endpoints. Read-only data API: no writes, no account actions, no dashboard access on the target site.

6 endpoints

search

3 cr

Search Auchan Portugal's online shop.

required
query
optional
category, brand, nutriscore, organic, national_product, min_price, max_price, sort, page, per_page

category

3 cr

List one Auchan category (id from categories) with the same row fields, filters and paging as…

required
category
optional
brand, nutriscore, organic, national_product, min_price, max_price, sort, page, per_page

promotions

3 cr

Auchan products on promotion in the online store right now (the site's own promotions facet).

required
—
optional
query, category, brand, nutriscore, organic, national_product, min_price, max_price, sort, page, per_page

product

3 cr

One Auchan product by the product_id a search row returns.

required
product_id
optional
store_id

categories

3 cr

Auchan Portugal's category tree from the shop menu (three levels).

required
—
optional
category

stores

2 cr

Auchan stores near a point, from the site's own store finder.

required
latitude, longitude
optional
radius_km

Every parameter, every allowed value →

Auchan Portugal API

4 of 6 endpoints, ready to run

View docs ↗

Milk prices at Auchan Portugal

3 credits1 required · 1 optional
POST/auchan-pt/v1/search
idle
// Press "Try it" and this pane shows exactly what the
// live site returned this second — including an empty
// result, if that is the truth. No key, no account.

How the Auchan Portugal API works

Auchan Portugal is a normal ReefAPI surface — the same four rules that hold for every other engine on the key.

01
Authenticate
x-api-key header

No OAuth app, no request signing, no per-site account. One key covers all 598 engines.

02
Call
POST /auchan-pt/v1/…

Every route is a POST with a JSON body. Parameters are validated against the published schema before anything is charged.

03
Pay
2 or 3 credits per call

Credits, not seats. Failed and blocked calls are never charged, and nothing is cached: every call reads the source live.

04
Read
{ ok, data, meta, error }

One envelope everywhere. meta carries latency_ms, record_count and the endpoint that answered.

From the category tree to a priced catalogue with EANs

Read the categories, walk each one page by page, then open the products you need, optionally for a store.

01categories
GET/auchan-pt/v1/categories

968 category ids with names, URLs and the parent-child tree.

02category?category=produtos-lacteos&per_page=100&page=1
GET/auchan-pt/v1/category?category=produtos-lacteos&per_page=100&page=1

100 products with price, was price and promotion dates or PVPR, price per kg or litre, labels and availability, plus the shop's total (1,805 for Produtos Lácteos).

03product?product_id=4020884&store_id=B85
GET/auchan-pt/v1/product?product_id=4020884&store_id=B85

EAN, promotions, order limits, ingredients, nutrition and the price at the Avenidas Novas supermarket.

An Auchan Portugal price feed with EANs for matching, promotion dates and store prices.

request
curl -X POST https://api.reefapi.com/auchan-pt/v1/search \
  -H "x-api-key: $REEF_KEY" \
  -H "content-type: application/json" \
  -d '{"query":"leite"}'
response envelope
{
  "ok": true,
  "data": { … },
  "meta": {
    "api": "auchan-pt",
    "endpoint": "search",
    "mode": "live",
    "latency_ms": …,
    "record_count": …
  },
  "error": null
}

What an Auchan Portugal field actually contains

Fields that read differently from how they look. Every row was measured against live auchan.pt responses on 2026-11-03.

FieldWhat it holds
price, price_unitThe price anyone pays now, in euros, per price_unit: un for packs, kg for goods sold by weight (Queijo Flamengo barra: 7.99 per kg).
regular_price, promotion_windowThe struck-through price of a running promotion and its dates (Manteiga Milhafre: 2.19 now, 2.49 before, from 2026-10-29 to 2026-11-11).
recommended_retail_priceThe manufacturer's recommended price (PVPR) the shop prints with a percentage (Iogurte Yoggi: 3.89 with PVPR 5.37, -28%). It is not a former Auchan price.
analytics_priceThe shop's own tracking price, kept as published. It is the price before a promotion or the PVPR, not the price you pay (2.49 for the 2.19 butter).
min_quantity_text, min_quantity_priceFor goods sold by weight: the smallest quantity you can order and its price ("Quant. Mínima = 200g", 1.60).
availablefalse when the shop marks the product "Indisponível online"; some of those rows print no price at all.
store (product)Which store the product price is for. Hypermarket Viseu matched the online price; supermarkets Avenidas Novas and Abrantes priced bananas 0.59 against 0.54 online, the same on every repeat.

Search and category rows are the online store's prices and range; pass store_id to the product call for a store's price. Clube Auchan member prices are not shown on the public shop.

Auchan Portugal coverage, measured

Every number below was read from live auchan.pt responses on 2026-11-03: searches in 8 product groups, 12 products read four ways, filters, paging and 4 stores.

Catalogue

61,089 products across 16 department categories on 2026-11-03, 30,557 of them in grocery departments; 16,770 on promotion.

Filters

Same minute, 'leite': 729 unfiltered, 48 Mimosa, 4 Nutri-Score A, 18 organic, 137 Portuguese, 147 between 1 and 2 euros, 167 in Produtos Lácteos.

Price accuracy

12 products: the search row, the product call, the shop's product page and its structured data agreed on price 12 of 12 times; EAN present on 12 of 12.

Paging

Produtos Lácteos, 1,805 products: pages 1 to 3 had 100 different products each; the last page had the remaining 5 and said no more pages follow.

Store prices

5 products in 4 stores, 3 repeats: online and Viseu identical, Avenidas Novas and Abrantes higher on 4 of 5 (bananas 0.59 against 0.54).

Limits

Up to 100 products per page; total printed on page 1; price filter in whole euros; search rows are online-store prices (store prices on the product call); no member prices; no stock counts.

What people build with Auchan Portugal

The jobs this data is most often used for.

6

endpoints

2/3

credits per call

01

Track Auchan Portugal prices and promotions with their start and end dates.

02

Compare Portuguese grocery prices per kg or litre with EANs for matching across retailers.

03

Refresh a full Auchan Portugal catalogue daily by walking its categories.

04

Compare a product's price between the online shop and individual Auchan stores.

What Auchan Portugal data costs

The cheapest call here is 2 credits, so $15/mo (Pro) buys 5,000 of them — $1.50 per 1,000 credits. Credits roll over and never expire, and failed or blocked calls are not charged.

Full pricing →
$0.67–$1.50 / 1,000 credits
  • 1,000 free credits on signup, no card
  • One key, all 598 APIs, one credit pool
  • Failed and blocked calls are never charged
  • Credits roll over and never expire

Call it in two lines

Sign up, get 1,000 credits and one key that works on every engine. Then this is the whole protocol.

curl
curl -X POST https://api.reefapi.com/auchan-pt/v1/search \
  -H "x-api-key: $REEF_KEY" \
  -H "content-type: application/json" \
  -d '{"query":"leite"}'
python
import requests

r = requests.post(
    "https://api.reefapi.com/auchan-pt/v1/search",
    headers={"x-api-key": REEF_KEY},
    json={
  "query": "leite"
},
)
print(r.json()["data"])
FAQ

Have a question? We got answers.

The questions people actually ask before wiring up Auchan Portugal.

Get a free key →
Do I need an Auchan account?▾

No. Everything is read logged out: the prices, promotions and product labels any visitor sees.

Can I download the whole catalogue?▾

Yes. `categories` returns every category id and `category` lists one with up to 100 products per page and the shop's own total on page 1. On 2026-11-03 the 16 department categories held 61,089 products (30,557 in the grocery departments), about 617 calls at 100 per page.

Do prices differ by store?▾

Yes. Pass a store_id from `stores` to the product call. In our measurements the Viseu hypermarket matched the online prices and two supermarkets were higher on 4 of 5 products, identical on every repeat.

Is the EAN included?▾

Yes, the product call returns the EAN Auchan publishes (12 of 12 products checked). Search rows carry the product_id, which works in the product call.

Which filters work?▾

category, brand, Nutri-Score, organic, Portuguese product and min_price / max_price in whole euros, plus sorting. Same minute, 'leite' went from 729 products to 48 Mimosa, 4 Nutri-Score A, 18 organic, 137 Portuguese and 147 between 1 and 2 euros.

What is the difference between regular_price and recommended_retail_price?▾

regular_price is what Auchan charged before a running promotion, with the promotion's dates. recommended_retail_price is the manufacturer's recommended price (PVPR), printed for comparison.

Does the product call include nutrition and ingredients?▾

Yes, when Auchan publishes them: ingredients, the nutrition table or the nutrition text as the producer filed it, plus every technical attribute on the product page.

How fresh is the data?▾

Every call reads auchan.pt live; nothing is cached.

What is the Auchan Portugal API?▾

Auchan Portugal API is a ReefAPI endpoint group for auchan portugal prices from auchan.pt: shelf price, promotion dates and was price, pvpr, price per kg or litre, ean, nutrition and store prices. It returns live JSON through POST requests under /auchan-pt/v1.

Is the Auchan Portugal API free to try?▾

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

Do I need an Auchan Portugal login or account?▾

No login to Auchan Portugal 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 Portugal 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 Portugal API use?▾

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

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

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

Need something this API does not do?

Name the endpoint, the field, or a source we do not carry yet. We ship new APIs every week and you would be first to get the key. Real people read every message and reply the same day.

0/4000

No account needed · we reply from [email protected]

Try it on your own data before you pay anything

The call above is the real endpoint, not a recording. A free key gives you 1,000 credits, the other 597 APIs, and the same envelope everywhere.

Endpoints, parameters and credit costs on this page are read from the live catalog and cannot drift from what the API accepts. Field notes were captured on 2026-11-03.