Darty APIdarty.com ↗
Access Darty.com product details, search results, and technical specifications via API. Get prices, availability, brand, and specs for French electronics listings.
What is the Darty API?
The Darty API covers France's major electronics retailer through 3 endpoints, returning product details, keyword search results, and technical specifications. The get_product_details endpoint retrieves title, EUR price, availability, brand, and Darty's internal codic product ID for any product page URL. The search_products endpoint returns up to 30 matching products per query, and get_product_specs maps the full spec sheet for any listed product.
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_iph17pro_256_ora.html' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace darty-com-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
from parse_apis.darty_api import Darty, Product, ProductSummary, ProductSpecs
darty = Darty()
# Search for products by keyword
for item in darty.productsummaries.search(query="samsung", limit=5):
print(item.title, item.price, item.url)
# Navigate from summary to full product details
product = item.details()
print(product.brand, product.currency, product.availability)
# Get technical specifications
spec_data = product.specs()
print(spec_data.specs)
# Direct product lookup by URL
product = darty.products.get(url="https://www.darty.com/nav/achat/telephonie/telephone_mobile_seul/iphone/apple_iph17pro_256_ora.html")
print(product.title, product.price, product.brand)
Get detailed information about a single Darty product including title, price, currency, availability, brand, and product ID. Accepts a full Darty product page URL. Returns one Product with all available metadata extracted from the page.
| Param | Type | Description |
|---|---|---|
| urlrequired | string | The full URL of the Darty product page (e.g. 'https://www.darty.com/nav/achat/telephonie/telephone_mobile_seul/iphone/apple_iph17pro_256_ora.html'). |
{
"type": "object",
"fields": {
"id": "string Darty product codic ID",
"url": "string product page URL",
"brand": "string brand name or null if not detected",
"price": "number price in EUR",
"title": "string product name",
"source": "string data extraction method used",
"currency": "string currency code (EUR)",
"availability": "string availability or delivery information"
},
"sample": {
"data": {
"id": "8083843",
"url": "https://www.darty.com/nav/achat/telephonie/telephone_mobile_seul/iphone/apple_iph17pro_256_ora.html",
"brand": "Apple",
"price": 1329,
"title": "Apple iPhone 17 Pro 256Go Orange cosmique",
"source": "html",
"currency": "EUR",
"availability": "Livraison gratuite"
},
"status": "success"
}
}About the Darty API
Product Details and Availability
The get_product_details endpoint accepts a full Darty product page URL and returns a structured object with the product title, price (numeric, in EUR), currency, availability (delivery or stock status text), brand, and Darty's id (the codic identifier). The url field echoes the canonical product page address. The brand field may return null when brand information is not present on the page.
Keyword Search
The search_products endpoint takes a query string — for example 'television' or 'iphone' — and returns a products array of up to 30 items from the first page of Darty results. Each product object includes title, url, price, and id, along with a count field indicating how many products were returned in that response. Pagination beyond the first page is not currently supported.
Technical Specifications
The get_product_specs endpoint accepts the same product page URL format as get_product_details and returns a specs object: a flat dictionary mapping specification attribute names to their values as they appear on the product page. This covers fields like screen resolution, energy class, connectivity, dimensions, and any other attributes Darty lists for that category. The exact keys vary by product category and individual listing.
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?+
- Monitor EUR price changes on specific Darty product URLs for consumer electronics
- Build a French-market product catalog by querying
search_productsfor category keywords - Compare technical specs across multiple TVs or laptops using
get_product_specs - Check real-time availability and delivery status for Darty listings using
get_product_details - Enrich an existing product database with Darty codic IDs and brand names
- Aggregate search results for a keyword across multiple French retailers including Darty
- Power a price alert service using the
priceandavailabilityfields from product detail responses
| 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 | 100 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 Darty have an official public developer API?+
What does `get_product_specs` return, and does it return the same fields for every product?+
specs dictionary mapping specification names to values as listed on that product's Darty page. The keys are not standardized across categories — a television listing will have different spec keys than a washing machine. Your code should handle variable key sets.Does `search_products` return results beyond the first page?+
Does the API return customer reviews or ratings for Darty products?+
Is the `availability` field a structured status or free-form text?+
availability field returns the delivery or stock status text as it appears on the Darty product page. It is a plain string and is not normalized to a fixed set of values, so parsing may vary across products and over time.