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 details from carrefour.es, returned as JSON.
What Does the Carrefour Spain API Return?
Everything visible and related to food, cooking, and recipes in the Carrefour Spain mobile web application, returned as clean JSON via a single REST call. The indexed product list typically contains 1,000–2,000 SKUs, focused on the most common ingredients used for cooking.
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, Jumbo, 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 all products available in Pepesto for 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"}'
{
"https://carrefour.es/spaghetti/barilla-spaghettoni-nr-7-1kg/p/4934814e0251": {
"entity_name": "Spaghetti",
"kg_verified": true,
"names": {
"es": "Barilla Spaghettoni n.º 7 1kg",
"en": "Barilla Spaghettoni No. 7 1kg"
},
"price": 340,
"currency": "EUR",
"price_per_meausure_unit": "0.34 / 100g",
"quantity_str": "1kg",
"quantity": {
"Unit": {
"HundredGrams": 10
},
"accurate_grams": 1000
}
}
}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.
Give your AI agent the ability to search Carrefour Spain's products, compare products, and place grocery orders — all programmatically via REST.
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.
Bridge meal planning and shopping: match recipe ingredients to real Carrefour Spain supermarket products and power dietary-aware grocery lists with live pricing.
Monitor Carrefour Spain's product range, pricing strategy, and promotional cadence at scale. Analyse SKU composition, spot price movements, and benchmark against competitors.
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 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.
Start pay-as-you-go — all 27 chains included, no per-chain pricing. Move to a monthly plan when you grow. See pricing →
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 reference.
Purchase via Stripe, then call /link with your email — your
key is returned immediately.
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.
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.
Everything visible and related to food, cooking, and recipes in the Carrefour Spain mobile web application, returned as clean JSON via a single REST call. The indexed product list typically contains 1,000–2,000 SKUs, focused on the most common ingredients used for cooking.
The standard catalog is indexed daily — product prices 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.