Darty APIdarty.com ↗
Extract product details, prices, technical specs, and customer reviews from Darty.com, France's major electronics retailer, via 4 structured JSON endpoints.
What is the Darty API?
The Darty.com API gives developers structured access to France's major electronics retailer across 4 endpoints: search products by keyword, fetch full product details (price, brand, promotional badges, EAN barcode), pull granular technical specifications, and paginate through verified post-purchase customer reviews. The get_product_details endpoint alone returns over ten distinct fields including codic ID, current and strikethrough prices, and discount percentage.
curl -X GET 'https://api.parse.bot/scraper/864b8924-1763-4c4c-ba5b-eeee97a33f41/get_product_details?url=https%3A%2F%2Fwww.darty.com%2Fnav%2Fachat%2Ftelephonie%2Ftelephone_mobile_seul%2Fiphone%2Fapple_iph18pm_256_rouge.html' \ -H 'X-API-Key: $PARSE_API_KEY'
Get detailed information about a single Darty product from its public product page: title, current price and currency, striked (pre-promotion) price and discount percentage when a promotion is shown, promotional badges (e.g. 'Bon plan', new-product picto), brand, product codic ID (also exposed as sku), EAN-13 (gtin13) when present, average customer rating on a 1-5 scale with the review count, delivery/availability text, full-resolution gallery image URLs, the long marketing description text, the 'points forts' key-feature bullets, and the sibling variant options (colour, storage, size, ...) with their product URLs. One page fetch per call. rating and review_count are null when the product has no customer reviews; old_price and discount_pct are null when no promotion is shown; ean, description may be null when the page does not publish them; badges, gallery_images, key_features and variants are arrays and may be empty. Variant options carry label and URL only: the page does not publish each sibling's price, so call get_product_details on a variant url for its price.
| Param | Type | Description |
|---|---|---|
| urlrequired | string | The full URL of the Darty product page, as emitted by search_products.products[*].url (e.g. 'https://www.darty.com/nav/achat/<category path>/<product slug>.html'). |
{
"type": "object",
"fields": {
"id": "string Darty product codic ID",
"ean": "string EAN-13 / gtin13 barcode or null",
"sku": "string product codic ID (same value as id)",
"url": "string product page URL",
"brand": "string brand name or null if not detected",
"price": "number current price in EUR",
"title": "string product name",
"badges": "array of string promotional/label texts (e.g. 'Bon plan', new-product picto label)",
"rating": "number average customer rating out of 5, null when the product has no reviews",
"source": "string data extraction method used",
"currency": "string currency code (EUR)",
"variants": "array of sibling variant options: dimension (e.g. 'Couleur'), label, url (product page), selected (boolean, true for the current product)",
"old_price": "number striked pre-promotion price in EUR, null when no promotion is shown",
"description": "string long product description text (newline separated paragraphs) or null",
"availability": "string availability or delivery information",
"discount_pct": "integer discount percentage shown by the site, null when no promotion",
"key_features": "array of string 'points forts' bullet points",
"review_count": "integer number of customer reviews, null when not published",
"gallery_images": "array of string full-resolution product image URLs"
},
"sample": {
"data": {
"id": "7684746",
"ean": "8806095299679",
"sku": "7684746",
"url": "https://www.darty.com/nav/achat/gps_communication/telephone_mobile/telephone_portable/samsung_s24_256go_indigo.html",
"brand": "Samsung",
"price": 543.47,
"title": "Samsung GALAXY S24 256GO INDIGO 5G",
"badges": [
"Bon plan"
],
"rating": 4.6,
"source": "html",
"currency": "EUR",
"variants": [
{
"url": "https://www.darty.com/nav/achat/gps_communication/telephone_mobile/telephone_portable/samsung_s24_256go_argent.html",
"label": "Argent",
"selected": false,
"dimension": "Couleur"
},
{
"url": "https://www.darty.com/nav/achat/gps_communication/telephone_mobile/telephone_portable/samsung_s24_256go_indigo.html",
"label": "Indigo",
"selected": true,
"dimension": "Couleur"
},
{
"url": "https://www.darty.com/nav/achat/gps_communication/telephone_mobile/telephone_portable/samsung_s24_128go_indigo.html",
"label": "128 Go",
"selected": false,
"dimension": "Capacité de stockage"
}
],
"old_price": 599,
"description": "Galaxy S24 | S24+\nGalaxy AI est là :\nEntourez simplement ce que vous voyez pour effectuer une recherche instantanée, traduisez vos conversations dans une autre langue en temps réel, retranscrivez votre voix en texte et obtenez un résumé, et retouchez vos photos sans effort - le tout grâce à l'IA.",
"availability": "Livraison gratuite",
"discount_pct": 9,
"key_features": [
"OS Android 14 - 256Go de ROM, 8Go de RAM",
"Écran Infinity-O 6.2\" - FullHD+ 120Hz",
"Processeur Exynos 2400",
"Un capteur photo principal de 50Mp - Galaxy AI est là"
],
"review_count": 9,
"gallery_images": [
"https://image.darty.com/darty?type=image&source=/market/2025/01/07/22738611_3723_1.jpg",
"https://image.darty.com/darty?type=image&source=/market/2024/01/16/22738611_3724_1.jpg"
]
},
"status": "success"
}
}About the Darty API
Product Search and Detail
search_products accepts a keyword query and returns up to 30 products from the first page of results, each with a title, url, price in EUR, Darty codic id, rating out of 5, and review_count. These URLs feed directly into the detail endpoints. get_product_details takes one of those product page URLs and returns richer fields: the EAN-13 barcode (ean), brand, current price, the pre-promotion strikethrough price and discount percentage when a promotion is active, and any badges such as 'Bon plan' or new-product labels.
Technical Specifications
get_product_specs returns a flat specs object mapping specification names to string values for a given product URL. Typical keys include storage capacity, screen size, camera resolution, processor model, and physical dimensions — but the exact set mirrors what Darty publishes for each product category, so smartphones return different keys than televisions or washing machines.
Customer Reviews with Pagination
get_product_reviews returns post-purchase reviews ('avis après achat') sorted newest first. Each review object includes date (ISO YYYY-MM-DD), rating, optional title, full text, author first name (may be null when the site anonymises it), author postcode, and the site's declared mastery level for the reviewer. The endpoint supports limit (1–100) and offset pagination; the response always includes has_more, next_offset, and total_reviews so callers can walk the full review set incrementally.
The Darty API is a managed, monitored endpoint for darty.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when darty.com changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official darty.com API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Track price drops and active promotions on Darty by comparing
priceagainststrikethrough_pricefields over time. - Build a French electronics price-comparison tool using
search_productsresults across multiple product categories. - Aggregate EAN barcodes via
get_product_detailsto match Darty listings against inventory in a product database. - Extract
get_product_specsdata to populate structured product sheets for comparison sites or internal catalogues. - Analyse customer sentiment by reading review
textandratingfields fromget_product_reviewsat scale. - Monitor new promotional
badgesacross product lines to detect Darty sale events as they launch. - Enrich an e-commerce feed with Darty
brand,rating, andreview_countdata for French market benchmarking.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 200 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
| Team | $300/mo | 20,000 | 300 req/min |
| Company | $1,000/mo | 100,000 | 500 req/min |
Each endpoint has a fixed posted price per successful call — most fall between 1 and 10 credits — shown on this API's page before you run it. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Darty offer an official public developer API?+
What does `get_product_details` return beyond basic price?+
get_product_details returns the EAN-13 barcode (ean), brand, current price in EUR, the pre-promotion strikethrough price and calculated discount percentage when a promotion is active, promotional badge labels (e.g. 'Bon plan'), average rating out of 5, and the product's Darty codic id. It requires a full product page URL as input.How does pagination work for `get_product_reviews`?+
limit (up to 100) and offset to control which slice of reviews is returned. Each response includes next_offset (null when there are no more reviews) and a has_more boolean. Start with offset: 0 and use next_offset from each response as the offset for the next call to walk through the full set.Does the API cover seller marketplace listings or third-party offers on Darty?+
Is `search_products` limited to the first page of results?+
search_products returns up to 30 products from the first result page for a given query. It does not currently support page or offset parameters for deeper result sets. You can fork this API on Parse and revise it to add multi-page search pagination.