# Cdiscount Product Offer

## Overview

| Property | Value |
|----------|-------|
| **Status** | active |
| **Method** | `GET` |
| **Endpoint** | `/v2/cdiscount/product/offer` |
| **Base URL** | `https://api.piloterr.com` |
| **Credit Cost** | 2 credits per call |
| **Documentation** | https://www.piloterr.com/library/cdiscount-product-offer |

## Description

Retrieve all marketplace seller offers for a Cdiscount product, including prices, seller ratings, shipping costs, and availability.

## 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/product/offer' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY'
```

## Example Response

### Lookup offers by offer URL

```json
{
  "results": [
    {
      "price": 8.68,
      "seller": {
        "url": "https://www.cdiscount.com/mpv-1818-brico-travo.html",
        "name": "brico-travo",
        "type": "VENDEUR PRO",
        "rating": {
          "rating": 3.2,
          "reviews_count": 249,
          "score_percentage": 60
        },
        "sales_count": 16152
      },
      "condition": "Neuf",
      "shipped_by": "brico-travo",
      "availability": "En Stock !",
      "delivery_time": "Entre le 10/04 et le 15/04",
      "shipping_cost": "6,99€",
      "shipping_country": "FRANCE"
    },
    {
      "price": 8.19,
      "seller": {
        "url": "https://www.cdiscount.com/mpv-406441-NMA.html",
        "name": "NMA",
        "type": "VENDEUR PRO",
        "rating": {
          "rating": 4.2,
          "reviews_count": 6,
          "score_percentage": 80
        },
        "sales_count": 348
      },
      "condition": "Neuf",
      "shipped_by": "NMA",
      "availability": "En Stock !",
      "delivery_time": "Entre le 02/04 et le 08/04",
      "shipping_cost": "8,81€",
      "shipping_country": "FRANCE"
    }
  ]
}
```

## Documentation

## Overview
Retrieve all marketplace seller offers for a given Cdiscount product. By passing an offer comparison URL, the API returns a ranked list of sellers with their prices, shipping details, ratings, and stock availability.

## Quickstart
```
GET https://api.piloterr.com/v2/cdiscount/product/offer?query=https://www.cdiscount.com/mp-352880-auc3283981039048.html
```

## Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| `query` | string | yes | Cdiscount product offer page URL |

## Response fields
| Field | Type | Description |
|---|---|---|
| `results` | array | List of seller offers |
| `results[].price` | number | Offer price in EUR |
| `results[].condition` | string | Product condition |
| `results[].shipped_by` | string | Shipping entity |
| `results[].availability` | string | Stock status |
| `results[].delivery_time` | string | Estimated delivery window |
| `results[].shipping_cost` | string | Shipping cost |
| `results[].shipping_country` | string | Shipping origin country |
| `results[].seller.name` | string | Seller name |
| `results[].seller.rating.rating` | number | Seller rating |
| `results[].seller.sales_count` | integer | Total seller sales |

## Notes
- Obtain the offer URL from the `multiple_offer_url` field in the Cdiscount Product API response.
- Only `/mp-{id}-{ean}.html` URL patterns are accepted.

## Main use cases
- Monitor all marketplace sellers for a product to automatically find the cheapest offer
- Track seller competition on Cdiscount to benchmark your listing strategy
- Build price comparison tools surfacing all seller offers side by side
- Set up price-drop alerts when a competitor undercuts your price