# Carrefour EU — 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 and browse Carrefour's European online product catalog to access pricing, promotions, availability, and detailed product information including nutritional data. Retrieve comprehensive product details across categories to compare prices and find current deals in real-time.

**Category:** E-commerce | **Website:** [carrefour.eu/](https://carrefour.eu/) | **Docs:** [parse.bot/marketplace/15d0db55-1379-42e5-8501-68dae95b8ed9/carrefour-eu-api](https://parse.bot/marketplace/15d0db55-1379-42e5-8501-68dae95b8ed9/carrefour-eu-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-carrefour-eu-api-15d0db55/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_product_details

Get detailed product information including description, nutritional data, and ingredients from a product detail page URL. The URL can be obtained from search_products results. Returns structured nutritional values when available on the product page.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `url` | string | Yes | Full URL of the product detail page (e.g., 'https://www.carrefour.be/fr/lourson-gateaux-chocolat-fourre-lait-150g/04971931.html'). Obtainable from search_products results[*].url. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-carrefour-eu-api-15d0db55/get_product_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"<string>"}'
```

### search_products

Search for products by keyword or browse by category. Returns a paginated list of products with prices, stock availability, promotion info, and basic details. Results are returned 36 per page. Pagination is zero-indexed. At least one of query or category_id should be provided for meaningful results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category_id` | string | No | Category ID to browse (e.g., 'ros002' for Crèmerie). Omitting returns all products. |
| `page` | integer | No | Page number, 0-indexed. |
| `query` | string | No | Search keyword (e.g., 'lait', 'chocolat'). If omitted, browses the specified category. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-carrefour-eu-api-15d0db55/search_products \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"category_id":"<string>","page":"<integer>","query":"<string>"}'
```