Carrefour Spain API — Real-Time Spain Grocery Data
Access Carrefour Spain's grocery catalog via the Pepesto API — live pricing in EUR, unit prices, promotional prices, and availability from carrefour.es, returned as JSON.
What Does the Carrefour Spain API Return?
Everything visible in the Carrefour Spain app and website, returned as clean JSON via a single REST call.
Carrefour Spain-specific: Unit prices (price per kilogram or per litre) are returned where displayed on carrefour.es.
Why Use an API Instead of Building Your Own Carrefour Spain Integration?
Developers who have tried to build their own Carrefour Spain data pipeline know the obstacles. Unofficial workarounds exist, but they come with real costs.
Carrefour Spain updates their website regularly — changing markup, adding rate limiting, or restructuring categories. Pepesto absorbs all of that. Your integration keeps working.
The same JSON field names work whether you're calling Carrefour Spain, Albert Heijn, Tesco, or any other supported chain. One integration for all of Europe.
Calling a REST API takes hours. Building, maintaining, and scaling your own Carrefour Spain data extraction takes months — and requires ongoing engineering resources.
DIY data extraction is fragile: a single layout change can silently break your pipeline. Pepesto monitors and updates integrations continuously so you don't have to.
Fetch Carrefour Spain Products in One Request
A single authenticated POST to /api/catalog returns
the full structured product catalog from Carrefour Spain.
curl -X POST https://s.pepesto.com/api/catalog \ -H "Authorization: Bearer $PEPESTO_API_KEY" \ -H "Content-Type: application/json" \ -d '{"supermarket_domain": "carrefour.es"}'
{
"supermarket_domain": "carrefour.es",
"products": [
{
"name": "Barilla Penne Rigate 500g",
"brand": "Barilla",
"pack_size": "500g",
"price": 1.89,
"unit_price": 0.38,
"unit_label": "per 100g",
"promo_price": 1.49,
"availability": "in_stock",
"category": "Pasta & Rice / Pasta / Penne",
"nutrition": {
"energy_kcal": 352,
"protein_g": 12.5,
"carbs_g": 70.5,
"fat_g": 1.5
}
}
]
}What Can You Build?
The Carrefour Spain API gives your product a live data layer on top of one of Spain's leading grocery retailers.
Compare Carrefour Spain prices against other Spain retailers in real time. Flag promotions, track price history, and surface the best deal per product.
Let users build a weekly shopping list and see the exact Carrefour Spain cost — including any active promotional prices — before they shop.
Match recipe ingredients to real Carrefour Spain products and show the true cost of cooking from a given menu. Drive grocery orders directly from your meal planner.
Access structured nutritional data — calories, macros, allergens — for the exact products sold at Carrefour Spain. Power food logging and dietary tracking with real supermarket data.
Monitor Carrefour Spain's product range, pricing strategy, and promotional cadence at scale. Track SKU introductions, price changes, and out-of-stock events over time.
Give your AI agent the ability to search Carrefour Spain's catalog, compare products by price or nutrition, and place grocery orders — all programmatically via REST.
Coverage & Data Freshness
Covers carrefour.es — Carrefour's Spanish online grocery store. This integration is scoped exclusively to Spain. It does not cover Carrefour France (carrefour.fr), Carrefour Belgium, Carrefour Italy, or any other Carrefour market.
Spain — carrefour.es. Pricing in EUR.
Daily. Promotional prices and weekly deals are included in every update cycle.
All products listed online at carrefour.es — including active promotions and full product details.
All product data and pricing is sourced from publicly listed pages on carrefour.es. Pepesto does not access retailer-gated pricing or any data not visible to a regular visitor. Products shown at a lower price due to a promotion or budget-tier range are included because they appear publicly on the site — not through any special retailer agreement.
How to get started
Three steps. No approval process. Your first call can be running within minutes.
Purchase a credit pack via Stripe. Pay-as-you-go from €0.05 per request. No monthly subscription, no minimum spend. Credits don't expire.
After purchase, call /link with your email — your API
key is returned immediately. No waiting, no approval form, no account
setup.
Make your first call to /api/catalog with
chain: "carrefour-es". Full endpoint reference and example
responses are in the API docs.
Purchase via Stripe, then call /link with your email — your
key is returned immediately. No approval process, no waiting.
Frequently Asked Questions about the Carrefour Spain API
Carrefour Spain does not offer a public developer API. Pepesto provides a maintained API layer that normalises Carrefour Spain's product catalog from carrefour.es into consistent JSON, updated daily.
The Pepesto Carrefour integration is scoped exclusively to carrefour.es (Spain). Other Carrefour markets — France, Belgium, Italy, Romania, and others — are not covered by this integration. If you need a specific Carrefour market, contact us.
Yes. Where Carrefour Spain displays a unit price (precio por kilo, precio por litro, etc.), this value is returned as a dedicated unit_price field alongside the standard package price.
Pepesto returns a unified JSON schema across all supported chains. Each Carrefour Spain product object includes name (in Spanish), price in EUR, unit price where available, promotional price, availability, category path, brand, and nutritional data.
Data from carrefour.es is refreshed daily, capturing current prices and active promotions on the Spanish storefront.
Buy Pepesto API credits, retrieve your key via /link, then query /catalog with chain set to carrefour-es. Full documentation is at pepesto.com/docs/grocery-shopping-api.
The standard catalog is indexed daily — prices, availability, and product details are refreshed every 24 hours. If your use case requires more frequent updates or push notifications on price changes, get in touch and we can discuss what's possible.
Other Supermarkets Available on Pepesto
One API key gives you access to 25+ European grocery chains with a consistent JSON schema.
