# Decathlon France — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Search for sporting goods across Decathlon France and retrieve detailed product information including prices, descriptions, images, and customer reviews. Get autocomplete suggestions as you search and access comprehensive product details to compare gear and read what other customers think.

**Category:** E-commerce | **Website:** [decathlon.fr/](https://decathlon.fr/) | **Docs:** [parse.bot/marketplace/6ef02526-e5a6-4911-a02d-0966bdb84d8a/decathlon-fr-api](https://parse.bot/marketplace/6ef02526-e5a6-4911-a02d-0966bdb84d8a/decathlon-fr-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-decathlon-fr-api-6ef02526/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_product_details

Fetch full product information by SKU UUID. Returns description, pricing, colors, weight, sports classification, variants, and review aggregates. The sku_id comes from search_products results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `sku_id` | string | Yes | Product SKU UUID from search_products results[*].sku_id |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-decathlon-fr-api-6ef02526/get_product_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"sku_id":"<string>"}'
```

### get_product_reviews

Fetch customer reviews and aggregate rating statistics for a product by model ID. Returns individual reviews with ratings, comments, author info, and attribute breakdowns. Pagination is 1-based with configurable page size up to 50.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `model_id` | string | Yes | Product model ID from search_products results[*].model_id or get_product_details.model_id |
| `page` | integer | No | Page number (1-based) |
| `page_size` | integer | No | Number of reviews per page (max 50) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-decathlon-fr-api-6ef02526/get_product_reviews \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model_id":"<string>","page":"<integer>","page_size":"<integer>"}'
```

### search_products

Full-text search over Decathlon.fr product catalog. Returns up to 40 products per page with pagination metadata. Queries that would redirect to a category page on the site are handled transparently. Each product carries pricing, brand, review summary, and available sizes.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Max number of products to return (up to 40 per page) |
| `page` | integer | No | Page number (1-based) |
| `query` | string | Yes | Search keyword (e.g., 'chaussures running', 'tente camping', 'velo') |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-decathlon-fr-api-6ef02526/search_products \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>","page":"<integer>","query":"<string>"}'
```

### search_suggestions

Autocomplete suggestions for a partial query. Returns matching categories with images, related query completions, and a handful of top product matches. Useful for building search-as-you-type UI or discovering category structure.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Search query for suggestions (e.g., 'running', 'vélo') |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-decathlon-fr-api-6ef02526/search_suggestions \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```