# Cdiscount Search ## Overview | Property | Value | |----------|-------| | **Status** | active | | **Method** | `GET` | | **Endpoint** | `/v2/cdiscount/search` | | **Base URL** | `https://api.piloterr.com` | | **Credit Cost** | 2 credits per call | | **Documentation** | https://www.piloterr.com/library/cdiscount-search | ## Description Extract product listings from Cdiscount search results or category pages for market intelligence and competitive analysis. ## Authentication - **Key Name:** `x-api-key` - **Location:** HTTP Header - **Get an API key:** https://app.piloterr.com/register ## Example Request ```bash curl --location --request GET 'https://api.piloterr.com/v2/cdiscount/search' \ --header 'Content-Type: application/json' \ --header 'x-api-key: YOUR_API_KEY' ``` ## Example Response ### Search for laptops ```json { "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 } } ``` ### Search for Microsoft Office ```json { "results": [ { "id": "aabld38423", "tag": "sw", "url": "https://www.cdiscount.com/informatique/logiciels-informatique/office-365-----version-2025--/f-10707-aabld38423.html?idOffre=4303503538", "image": "https://www.cdiscount.com/pdt2/4/2/3/1/300x300/aabld38423/rw/office-365-----version-2025--.jpg", "price": 4.9, "title": "MICROSOFT 365 - PACK OFFICE Version 2026", "images": [ "https://www.cdiscount.com/pdt2/4/2/3/1/300x300/aabld38423/rw/office-365-----version-2025--.jpg", "https://www.cdiscount.com/pdt2/4/2/3/1/140x140/aabld38423/rw/office-365-----version-2025--.jpg" ], "is_new": true, "rating": 2.3, "seller": { "id": 370417, "name": "Logiciel Direct" }, "is_cdav": true, "brand_id": 3980, "currency": "EUR", "offer_id": 4303503538, "condition": "Neuf", "category_id": 1000004213, "is_sponsored": true, "min_quantity": 1, "category_path": "0K/0K08/0K0806/0K080601", "department_id": 10707, "free_shipping": true, "reviews_count": 3, "original_price": null, "new_offer_quantity": 0, "new_offer_min_price": 0, "used_offer_quantity": 0, "used_offer_min_price": 0 }, { "id": "aacua55338", "url": "https://www.cdiscount.com/informatique/logiciels-informatique/windows-11-famille--pack/f-10707-aacua55338.html", "image": "https://www.cdiscount.com/pdt2/3/3/8/1/300x300/aacua55338/rw/windows-11-famille--pack.jpg", "price": 4.9, "title": "WINDOWS 11 FAMILLE + PACK OFFICE Version 2026", "images": [ "https://www.cdiscount.com/pdt2/3/3/8/1/300x300/aacua55338/rw/windows-11-famille--pack.jpg", "https://www.cdiscount.com/pdt2/3/3/8/1/140x140/aacua55338/rw/windows-11-famille--pack.jpg" ], "is_new": true, "seller": { "id": 132273, "name": "Fast Software" }, "is_cdav": true, "brand_id": 3980, "currency": "EUR", "offer_id": 4310321497, "condition": "Neuf", "category_id": 1000004213, "is_sponsored": false, "min_quantity": 1, "category_path": "0K/0K08/0K0806/0K080601", "department_id": 10707, "free_shipping": true, "original_price": null, "new_offer_quantity": 0, "new_offer_min_price": 0, "used_offer_quantity": 0, "used_offer_min_price": 0 } ], "pagination": { "next": 3, "current": 2, "other_pages": [ 1, 3, 4, 5, 6 ], "total_pages": 6, "has_next_page": true } } ``` ## Documentation ## Overview Extract product listings from any Cdiscount search or category page. Returns a structured list of offers with prices, seller details, category metadata, ratings, and pagination. ## Quickstart ``` GET https://api.piloterr.com/v2/cdiscount/search?query=https://www.cdiscount.com/search/10/laptop.html ``` ## Parameters | Parameter | Type | Required | Description | |---|---|---|---| | `query` | string | yes | Cdiscount search or category page URL | ## Response fields | Field | Type | Description | |---|---|---| | `results` | array | List of product offers | | `results[].id` | string | Cdiscount product ID | | `results[].url` | string | Product page URL | | `results[].title` | string | Product title | | `results[].price` | number | Current price in EUR | | `results[].original_price` | number | Strikethrough price before discount | | `results[].offer_id` | integer | Offer ID for the listed price | | `results[].seller.name` | string | Seller name | | `results[].is_sponsored` | boolean | Sponsored placement | | `pagination` | object | Pagination metadata | ## Notes - The same product ID may appear multiple times with different sellers or offers. - Pagination parameters included in the URL are respected. - Sponsored results are flagged with `is_sponsored: true` and may include `tag: sw`. ## Main use cases - Monitor keyword rankings and product visibility on Cdiscount - Aggregate competitor pricing across product categories - Feed price comparison engines with live search data - Build keyword-based product discovery pipelines