# Amazon.fr Listing Scraper

Scrape product information (ASIN, title, price, etc.) from Amazon with keyword input

- Template page: [https://www.octoparse.com/template/amazon-fr-listing-scraper](https://www.octoparse.com/template/amazon-fr-listing-scraper)
- Categories: E-Commerce
- Status: `PUBLISHED`
- Run mode: `BOTH`

## Pricing

Free.

## What is an Octoparse template?

An Octoparse template is a ready-to-use scraping workflow with predefined inputs and structured outputs. Use the exact parameter keys below; do not invent parameters.

## Overview

This ready-to-use template collects structured data from search-results pages.

## Output

The current workflow extracts 14 fields, including `Site`, `adresse`, `Mot_clé`, `Page_actuel`, `Nom_du_produit`, `sponsoriser`, `Page_produit`, `ASIN`, `Classement`, `Nombre_du_commentaire`, `Page_commentaire`, `Prix_actuel`, `Prix_original`, `Image`.

## Use Cases

- Use structured results for research, comparison, and monitoring.
- Collect rows without building the extraction workflow from scratch.
- Combine results with other templates for downstream enrichment.
- Review a representative result before starting a large batch.

## Why Octoparse

- **No coding required:** complete Postcode, Keyword (1-5) and start the template in local or cloud mode.
- **Flexible export:** review and export results as CSV, Excel, or JSON.

## Input

### Postcode

Required. 111 Constraints: minLength=1; maxLength=100.

### Keyword (1-5)

Required. 111 Constraints: minItems=1; maxItems=5; items.minLength=1; items.maxLength=5000.

## How to Use

# Amazon.fr Listing Scraper – Usage Guide

## Purpose
Collects Amazon.fr listing/search-result product data (ASIN, title, price, etc.) using keyword and postcode inputs.

## Input parameters
- **Postcode** (required): enter the postcode requested by the template.
- **Keyword (1-5)** (required): enter one or more keywords, one per line.

## How to run
1. Open the template and select **Try it** or **Start**.
2. Enter the required inputs.
3. Run the task locally. Keep your computer and Octoparse open until the run finishes.
4. Review the returned rows and export or process the structured data.

## Returned fields
Returns listing/search-result fields including:

`Site`, `adresse`, `Mot_clé`, `Page_actuel`, `Nom_du_produit`, `sponsoriser`, `Page_produit`, `ASIN`, `Classement`, `Nombre_du_commentaire`, `Page_commentaire`, `Prix_actuel`, `Prix_original`, `Image`

Some fields, such as `Prix_actuel`, `Prix_original`, and `Image`, may be empty when the source record does not provide them.

## Practical tips
- Start with one or a few inputs and review the returned rows before scaling.
- Use the most specific valid postcode to reduce unrelated or duplicate records.
- Use a stable identifier from `Site`, `adresse`, `Mot_clé`, `Page_actuel`, `Nom_du_produit`, `sponsoriser`, `Page_produit`, `ASIN`, `Classement`, and `Nombre_du_commentaire` as the deduplication key when available.
- Use `ASIN` values for further Amazon.fr detail or review scraping with the appropriate detail-page/review template.

## Cost
This template currently has no per-line charge. Octoparse plan or resource limits may still apply.

## Scheduling and API
- Schedule recurring local runs and export collected data from Octoparse. Keep your computer and Octoparse open during scheduled local runs.
- Scheduling and API access may require a paid Octoparse plan.
- Reuse data through Octoparse OpenAPI or the [AgentTools API](https://www.octoparse.com/docs/en/api-reference/agenttools-api/search-templates).

## Limitations
- The template runs locally, so your computer and Octoparse must stay open while the task is running.
- It collects listing/search-result fields only, not complete detail-page data. Use a detail-page template when deeper record data is required.

## Limitations

Results depend on what the source site exposes at run time. Fields may be empty when a source page does not provide a value. The template enforces the input limits shown above.

## Tips

Use specific, valid inputs and review a representative result before starting a large batch. Remove duplicate inputs when repeated records are not needed.

## FAQ

### What do I need to enter?

Use the exact inputs and limits listed above.

### What data does this template return?

See Output Schema below; availability can vary by source record.

### How is usage billed?

See the Pricing section above for current pricing and billing details.

## Related Templates

- [eBay Listing Page Scraper (by keyword)](https://www.octoparse.com/template/ebay-product-list-scraper-by-keyword)
- [Booking.com Hotel Listing Scraper](https://www.octoparse.com/template/booking-com-scraper)
- [Google Maps Store Listing Scraper (Japan)](https://www.octoparse.com/template/google-maps-store-listing-scraper)
- [Zillow Listing Scraper (by URL)](https://www.octoparse.com/template/zillow-scraper)

## Input Schema

```json
{
  "title": "Amazon.fr Listing Scraper input",
  "description": "Input parameters configured for the current published template version.",
  "type": "object",
  "schemaVersion": 1,
  "additionalProperties": false,
  "properties": {
    "postcode": {
      "title": "Postcode",
      "description": "111",
      "type": "string",
      "minLength": 1,
      "maxLength": 100,
      "x-octoparse": {
        "apiEnabled": true
      }
    },
    "keyword": {
      "title": "Keyword (1-5)",
      "description": "111",
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1,
        "maxLength": 5000
      },
      "minItems": 1,
      "maxItems": 5,
      "x-octoparse": {
        "apiEnabled": false
      }
    }
  },
  "required": [
    "postcode",
    "keyword"
  ]
}
```

## Input JSON Example

Example 1

```json
{
  "keyword": [
    "kenwood"
  ],
  "postcode": "750000"
}
```


## Output Schema

```json
{
  "schemaVersion": 1,
  "type": "object",
  "properties": {
    "Site": {
      "type": "string",
      "description": ""
    },
    "adresse": {
      "type": "string",
      "description": ""
    },
    "Mot_clé": {
      "type": "string",
      "description": ""
    },
    "Page_actuel": {
      "type": "string",
      "description": ""
    },
    "Nom_du_produit": {
      "type": "string",
      "description": ""
    },
    "sponsoriser": {
      "type": "string",
      "description": ""
    },
    "Page_produit": {
      "type": "string",
      "description": ""
    },
    "ASIN": {
      "type": "string",
      "description": ""
    },
    "Classement": {
      "type": "string",
      "description": ""
    },
    "Nombre_du_commentaire": {
      "type": "string",
      "description": ""
    },
    "Page_commentaire": {
      "type": "string",
      "description": ""
    },
    "Prix_actuel": {
      "type": "string",
      "description": ""
    },
    "Prix_original": {
      "type": "string",
      "description": ""
    },
    "Image": {
      "type": "string",
      "description": ""
    }
  },
  "title": "Amazon.fr Listing Scraper output",
  "description": "Initial output fields derived from the current published implementation. Field descriptions are maintained by Data Center; production field names and types should be refreshed from recent successful runs.",
  "additionalProperties": false
}
```

## Output Example

Example 1

```json
{
  "Site": "Amazon.fr",
  "adresse": "\n                    75000‌\n                ",
  "Mot_clé": "kenwood",
  "Page_actuel": "1",
  "Nom_du_produit": "MultiPro Compact - Robot Multi. 800W Bowl 2.1L 9 Accessories",
  "sponsoriser": "",
  "Page_produit": "https://amazon.fr/-/en/Kenwood-MultiPro-Compact-Accessories-FDM301SS/dp/B075XN9MRG/ref=sr_1_1?dib=eyJ2IjoiMSJ9.MkMA7XG2Vfkv2huY68kUkdl__T1VMDdokp0RI8LVaPMnPF2U_pw2dO5JIYQ5Sibg8wxrvxP3v-naSNM7ON7Ha0SjilRJ76mGobcZ1nDYa8PjA4-2eT0r3i6BIaa6VoAwN0xH6yTGqQLUnuTdJHLwJROwq0orprAKdLEQyEKnAlemS010orwwmHPX0-70AJsdLmTXJfgfStu2WGzOi2RUyEBORVagyCbUEXEumWea3Bg3g383gfFSpUmd0K_4UQXVFwWXIyKasfIdGevaKdNe1nzVK3-ml85AzH2TW6JoZBk.9oJNW6dvgSvrMeWMemXbVpUoB3Ee883kKX38JvIl6Ng&dib_tag=se&keywords=kenwood&qid=1794821335&sr=8-1",
  "ASIN": "B075XN9MRG",
  "Classement": "4.4 out of 5 stars",
  "Nombre_du_commentaire": "1,847 ratings",
  "Page_commentaire": "https://www.amazon.fr/-/en/Kenwood-MultiPro-Compact-Accessories-FDM301SS/dp/B075XN9MRG/ref=sr_1_1?dib=eyJ2IjoiMSJ9.MkMA7XG2Vfkv2huY68kUkdl__T1VMDdokp0RI8LVaPMnPF2U_pw2dO5JIYQ5Sibg8wxrvxP3v-naSNM7ON7Ha0SjilRJ76mGobcZ1nDYa8PjA4-2eT0r3i6BIaa6VoAwN0xH6yTGqQLUnuTdJHLwJROwq0orprAKdLEQyEKnAlemS010orwwmHPX0-70AJsdLmTXJfgfStu2WGzOi2RUyEBORVagyCbUEXEumWea3Bg3g383gfFSpUmd0K_4UQXVFwWXIyKasfIdGevaKdNe1nzVK3-ml85AzH2TW6JoZBk.9oJNW6dvgSvrMeWMemXbVpUoB3Ee883kKX38JvIl6Ng&dib_tag=se&keywords=kenwood&qid=1794821335&sr=8-1#customerReviews",
  "Prix_actuel": "€69.99",
  "Prix_original": "€79.99",
  "Image": "https://m.media-amazon.com/images/I/71qJbYp1bSL._AC_UL320_.jpg"
}
```

## API

`POST https://openapi.octoparse.com/api/agentTools/executeTask`

This is the OpenAPI Agent Tools `executeTask` endpoint. Authenticate with a Bearer token.

Request body:

`templateName` is the template slug; `parameters` is a JSON object string whose keys match Input Schema; `taskName`, `idempotencyKey`, and `maxCollectedRows` are optional.

Obtain a token:

```http
POST https://openapi.octoparse.com/token
Content-Type: application/json

{
  "username": "YOUR_USERNAME",
  "password": "YOUR_PASSWORD",
  "grant_type": "password"
}
```

Use `data.access_token` as `Authorization: Bearer <token>`. After starting, poll `getTaskStatus` and export with `exportData`.

```json
{
  "templateName": "amazon-fr-listing-scraper",
  "taskName": "Amazon.fr Listing Scraper",
  "parameters": "{\"keyword\":[\"kenwood\"],\"postcode\":\"750000\"}"
}
```

## Python Example

```python
import json
import requests

OPENAPI_BASE = "https://openapi.octoparse.com"
ACCESS_TOKEN = "YOUR_ACCESS_TOKEN"

parameters = json.loads("{\"keyword\":[\"kenwood\"],\"postcode\":\"750000\"}")

response = requests.post(
    f"{OPENAPI_BASE}/api/agentTools/executeTask",
    headers={
        "Authorization": f"Bearer {ACCESS_TOKEN}",
        "Content-Type": "application/json",
    },
    json={
        "templateName": "amazon-fr-listing-scraper",
        "taskName": "Amazon.fr Listing Scraper",
        "parameters": json.dumps(parameters, ensure_ascii=False),
    },
    timeout=60,
)
print(response.status_code)
print(response.json())
```

## HTTP/cURL Example

```bash
curl -X POST "https://openapi.octoparse.com/api/agentTools/executeTask" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  --data-binary @- <<'JSON'
{
  "templateName": "amazon-fr-listing-scraper",
  "taskName": "Amazon.fr Listing Scraper",
  "parameters": "{\"keyword\":[\"kenwood\"],\"postcode\":\"750000\"}"
}
JSON
```

## MCP Setup

Connect an MCP-compatible AI client to `https://mcp.octoparse.com` using browser OAuth or an Octoparse API key. Find `amazon-fr-listing-scraper`, inspect its inputs, create a cloud task with the exact Input Schema keys, and export JSON results.

## Machine-readable Resources

- [Template contract](https://www.octoparse.com/templates/amazon-fr-listing-scraper.json)
- [Manifest](https://www.octoparse.com/templates/amazon-fr-listing-scraper-manifest.json)
