auchan.fr APIauchan.fr ↗
Access Auchan.fr product data via API. Search groceries, get nutritional details, browse categories, find stores by postal code, and fetch autocomplete suggestions.
curl -X GET 'https://api.parse.bot/scraper/86e0680a-9895-4fa6-a201-a7734f094e13/search_products?query=lait' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for products by keyword on Auchan.fr. Returns paginated product listings with name, brand, price, rating, and availability information.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number for pagination. |
| queryrequired | string | Search keyword (e.g. 'lait', 'fromage') |
{
"type": "object",
"fields": {
"page": "integer, current page number",
"query": "string, the search query used",
"products": "array of product objects with id, name, brand, image_url, url, productId, rating, review_count, availability",
"total_count": "integer, total number of products matching the query"
},
"sample": {
"data": {
"page": 1,
"query": "lait",
"products": [
{
"id": "b2031c8f-0e07-40dd-815a-577444a84cc8",
"url": "https://www.auchan.fr/lactel-matin-leger-lait-facile-a-digerer-sans-lactose/pr-C1177828",
"name": "LACTELMatin léger Lait facile à digérer sans lactose",
"brand": "LACTEL",
"rating": "4.7",
"image_url": "https://cdn.auchan.fr/media/A0219991110000790576PRIMARY_2048x2048/B2CD/?format=rw&quality=75&width=150&height=150",
"productId": "C1177828",
"availability": "out_of_stock",
"review_count": "228"
}
],
"total_count": 14
},
"status": "success"
}
}About the auchan.fr API
The Auchan.fr API exposes 6 endpoints covering product search, full product details, category browsing, store lookup, and autocomplete suggestions from France's Auchan grocery retailer. The get_product_details endpoint alone returns over 10 fields including ingredients, nutritional features, storage instructions, origin, and manufacturer contact — giving developers structured access to the product catalog without building a scraper themselves.
Product Search and Details
The search_products endpoint accepts a query string (e.g. 'lait', 'fromage') and an optional page integer for pagination. It returns an array of product objects — each with id, name, brand, image_url, url, productId, rating, review_count, and availability — plus a total_count field reflecting how many results Auchan returns for the query. To dig into a specific item, pass its product_id (e.g. 'C1177828') to get_product_details, which returns richer fields: ingredients, conservation (storage instructions), description, origin (including country of manufacture), features (a key-value map of additional product attributes), and contact (manufacturer details).
Category Browsing
get_categories returns the full navigation tree from the Auchan.fr homepage — each category object includes name, url, and id. Those IDs feed directly into browse_category, which accepts a category_id (e.g. 'n01') and an optional page parameter. The endpoint handles the ca- prefix automatically if you omit it. The response mirrors the search_products shape: a paginated array of product objects plus the category_id that was queried.
Store Lookup and Autocomplete
get_stores takes a French postal code (2–5 digits, e.g. '59000' for Lille) and returns nearby Auchan locations with id, name, type, type_name, address, zipcode, city, latitude, longitude, and distance. Coverage varies by region — dense urban areas like Paris (75) may return an empty stores array if no Auchan locations exist nearby. The get_search_suggestions endpoint accepts a query string and returns suggestion objects with text, url, and type (either 'keyword' or 'category'); category-type suggestions also carry additional refinement fields. Note that suggestions come from a pre-cached set and may return an empty list for uncommon queries.
- Build a French grocery price tracker by querying
search_productsrepeatedly for target keywords and logging the returnedavailabilityand price fields over time. - Populate a nutrition comparison tool using
ingredients,features, andconservationfields fromget_product_details. - Create a category browser or store-front clone by chaining
get_categorieswithbrowse_categoryto page through Auchan's full product hierarchy. - Implement a store locator for a logistics or delivery app using
get_storeswith user-supplied French postal codes and the returnedlatitude/longitudefields. - Drive a product search autocomplete widget by piping user keystrokes through
get_search_suggestionsand surfacing the returnedtextandtypefields. - Aggregate brand presence data by collecting
brandandratingfields across paginatedsearch_productsresults for a set of product categories.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Auchan.fr have an official public developer API?+
What does `get_product_details` return beyond what `search_products` provides?+
search_products and browse_category return surface-level fields: name, brand, image_url, rating, review_count, and availability. get_product_details adds ingredients, conservation (storage/handling instructions), description, origin (with country of manufacture), contact (manufacturer details), and a features key-value map for additional attributes specific to each product.Are store hours or real-time stock levels available through the store or product endpoints?+
get_stores returns location data (address, coordinates, distance, store type) but not opening hours or per-store stock levels. search_products returns an availability field at the catalog level, not tied to a specific store. You can fork this API on Parse and revise it to add an endpoint that retrieves per-store availability or opening hours if that data becomes addressable.How does pagination work across endpoints that return product lists?+
search_products and browse_category accept an optional page integer parameter. search_products also returns a total_count field, so you can calculate how many pages exist for a given query. browse_category does not return a total count in its current response shape, so pagination requires stepping through pages until the products array is empty or shorter than expected.