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

> 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 for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.beta.paywithlocus.com/api/wrapped/credits/amazon-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 deals

Retrieve current deals from the Amazon.fr Goldbox page.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/amazon-france/get-deals \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/amazon-france/get-product-details \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/amazon-france/get-product-offers \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/amazon-france/get-product-reviews \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/amazon-france/get-product-specifications \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/amazon-france/get-seller-profile \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/amazon-france/search-products \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>","query":"<string>","sort":"<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.