Cdiscount Search
GET
Extract product listings from Cdiscount search results or category pages for market intelligence and competitive analysis.
Credit cost: 2 credits per call
ApiKeyAuthheader
x-api-key<token>Your API key. Include it in the x-api-key header for every request.
query*stringCdiscount search results page URL. Use any URL from a search or category browse on cdiscount.com.
Example:
https://www.cdiscount.com/search/10/laptop.htmlNotes:
- You can use keyword search URLs (e.g.
/search/10/{keyword}.html) or category browse URLs (e.g./informatique/ordinateurs-pc-portables/...) - Pagination and filter parameters present in the URL are respected.
fields?stringComma-separated list of response fields to return, with dot notation for nested fields (e.g. name,location.city).
is_async?booleanRun the request as a background job: the API answers 202 with a job_id to poll on GET /v1/jobs/{id}.
Default
falsesoft_fail?booleanReturn HTTP 200 even when the request fails; the error is in the error field of the body.
Default
falseSuccessful response
application/json- response
results?array<>pagination?curl -X GET 'https://api.piloterr.com/v2/cdiscount/search?query=string'Example Response
{ "results": [ { "id": "aaaph06865", "url": "https://www.cdiscount.com/informatique/ordinateurs-pc-portables/acemagic-pc-portables-gaming/f-1070992-aaaph06865.html", "image": "https://www.cdiscount.com/pdt2/8/6/5/1/300x300/aaaph06865/rw/acemagic-pc-portables-gaming.jpg", "price": 429.99, "title": "ACEMAGIC PC Portables Gaming - 15.6\" FHD, AMD Ryzen 7 5700U, 16Go RAM, 512Go SSD", "images": [ "https://www.cdiscount.com/pdt2/8/6/5/1/300x300/aaaph06865/rw/acemagic-pc-portables-gaming.jpg", "https://www.cdiscount.com/pdt2/8/6/5/1/140x140/aaaph06865/rw/acemagic-pc-portables-gaming.jpg" ], "is_new": true, "rating": 4, "seller": { "id": 405259, "name": "BOOMING" }, "is_cdav": true, "brand_id": 221204, "currency": "EUR", "offer_id": 4258700481, "condition": "Neuf", "category_id": 1000004592, "is_sponsored": false, "min_quantity": 1, "category_path": "0K/0K07/0K0701/0K070101", "department_id": 1070992, "free_shipping": true, "reviews_count": 2, "original_price": 499.9, "new_offer_quantity": 0, "new_offer_min_price": 0, "used_offer_quantity": 0, "used_offer_min_price": 0 }, { "id": "aaaaq86960", "url": "https://www.cdiscount.com/informatique/ordinateurs-pc-portables/ordinateur-portable-laptop-hp/f-1070992-aaaaq86960.html", "image": "https://www.cdiscount.com/pdt2/9/6/0/1/300x300/aaaaq86960/rw/ordinateur-portable-laptop-hp.jpg", "price": 759.99, "title": "ORDINATEUR PORTABLE LAPTOP HP 15-EH3001SF RAM 16 Go SSD 512 Go - ARGENT NATUREL", "images": [ "https://www.cdiscount.com/pdt2/9/6/0/1/300x300/aaaaq86960/rw/ordinateur-portable-laptop-hp.jpg", "https://www.cdiscount.com/pdt2/9/6/0/1/140x140/aaaaq86960/rw/ordinateur-portable-laptop-hp.jpg" ], "is_new": true, "seller": { "id": 80174, "name": "MegaMarket" }, "is_cdav": true, "brand_id": 766, "currency": "EUR", "offer_id": 4213440156, "condition": "Neuf", "category_id": 1000004592, "is_sponsored": false, "min_quantity": 1, "category_path": "0K/0K07/0K0701/0K070101", "department_id": 1070992, "free_shipping": true, "original_price": 999.99, "new_offer_quantity": 0, "new_offer_min_price": 0, "used_offer_quantity": 0, "used_offer_min_price": 0 } ], "pagination": { "next": 2, "current": 1, "other_pages": [ 2 ], "total_pages": 2, "has_next_page": true }}