# Decathlon France — Wrapped API

> **You are on:** `https://api.beta.paywithlocus.com/api` | [llms.txt](https://beta.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 for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.beta.paywithlocus.com/api/wrapped/credits/decathlon-france/`
**Auth:** `Authorization: Bearer <LOCUS_CREDITS_SECRET_KEY>` (an `lcr_` secret key or a scoped `lcac_` agent credential)
**Required header:** `Idempotency-Key: <fresh UUID per call>`. A retry with the same key replays the stored result without a new charge.
**Response:** the provider response after any endpoint-specific normalization. `X-Locus-Credits-Charged` carries the charge and `X-Locus-Credits-Balance` the remaining balance. Insufficient credits return `402` before the provider is called.
**Pricing:** estimated costs below are USD. Locus debits the credit equivalent at your workspace rate.

Full call contract: https://docs.paywithlocus.com/api-reference/introduction

> Using a Pay With Locus wallet key (`claw_` prefix)? Wallet routes are documented separately: https://docs.paywithlocus.com/wrapped-apis/for-agents

## 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.beta.paywithlocus.com/api/wrapped/credits/decathlon-france/get-product-details \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/decathlon-france/get-product-reviews \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/decathlon-france/search-products \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/decathlon-france/search-suggestions \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```

## Next steps

- [All wrapped API providers](https://beta.paywithlocus.com/wapi/index.md): pick another provider.
- [Find and call tools](https://beta.paywithlocus.com/agent/tools.md): price ceilings, async results, and errors.
- [Credits and billing](https://beta.paywithlocus.com/agent/billing.md): what a call costs and how to add credits.
- [Agent docs index](https://beta.paywithlocus.com/agent/index.md): every Locus agent page.