# Amazon (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.

> Scrape product data from Amazon.fr, including search results, product details, specifications, seller offers, customer reviews, and current deals.

**Category:** E-commerce | **Website:** [amazon.fr/](https://amazon.fr/) | **Docs:** [parse.bot/marketplace/8ce56c56-8ef3-4049-91b8-e922c359d1d1/amazon-fr-api](https://parse.bot/marketplace/8ce56c56-8ef3-4049-91b8-e922c359d1d1/amazon-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-amazon-fr-api-8ce56c56/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_deals

Retrieve current deals from the Amazon.fr Goldbox page.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-amazon-fr-api-8ce56c56/get_deals \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_product_details

Retrieve full details for a product by ASIN, including title, price, rating, reviews count, specifications, images, bullet points, and variants. Makes a single request to the product page.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `asin` | string | Yes | Amazon product ASIN (10-character alphanumeric identifier) |

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

### get_product_offers

Get seller offers and buying options for a product ASIN. Extracts the buy box offer and any additional tabular offers from the product page. Returns price, seller name, condition, and availability for each offer.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `asin` | string | Yes | Amazon product ASIN (10-character alphanumeric identifier) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-amazon-fr-api-8ce56c56/get_product_offers \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"asin":"<string>"}'
```

### get_product_reviews

Retrieve customer reviews for a product by ASIN. Reviews are extracted from the product page and include up to approximately 13 top reviews per request. Each review includes author, rating, title, body text, date, and verified purchase status.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `asin` | string | Yes | Amazon product ASIN (10-character alphanumeric identifier) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-amazon-fr-api-8ce56c56/get_product_reviews \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"asin":"<string>"}'
```

### get_product_specifications

Extract the technical specifications and product details for a product by ASIN. Returns the product title and a key-value map of all specifications found on the product page. Shares the same underlying request as get_product_details but returns only specifications.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `asin` | string | Yes | Amazon product ASIN (10-character alphanumeric identifier) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-amazon-fr-api-8ce56c56/get_product_specifications \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"asin":"<string>"}'
```

### get_seller_profile

Retrieve a seller's profile including name and VAT (TVA) number. Note: This endpoint is heavily protected by AWS WAF.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `seller_id` | string | Yes | Amazon Seller ID |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-amazon-fr-api-8ce56c56/get_seller_profile \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"seller_id":"<string>"}'
```

### search_products

Search for products on Amazon.fr. Returns paginated results with product title, price, rating, review count, and image. Paginates via page number. May occasionally be blocked by Amazon's bot protection, in which case proxy rotation resolves the issue.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number for pagination |
| `query` | string | Yes | Search keyword (e.g. 'casque bluetooth', 'iphone') |
| `sort` | string | No | Sort order. Accepted values: 'price-asc-rank', 'price-desc-rank', 'review-rank', 'date-desc-rank' |

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