# Amazon Product Listing Scraper(for Spain)

Scrape basic information (title, price, stars, number of reviews, etc.) from Amazon by keywords.

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

## 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 8 fields, including `ASIN`, `Current_Time`, `Detail_Page_URL`, `Keyword`, `Number_of_Reviews`, `Price`, `Star_Rating`, `Title`.

## 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 Search keywords (up to 100), Number of products per keyword, Delivery postcode and start the template in cloud mode.
- **Flexible export:** review and export results as CSV, Excel, or JSON.

## Input

### Search keywords (up to 100)

Required. Enter one keyword per item, up to 100 keywords. Each keyword may contain up to 200 characters. ScrapeNumber applies separately to each keyword. Constraints: minItems=1; maxItems=100; items.minLength=1; items.maxLength=200.

### Number of products per keyword

Optional. Maximum number of product records to collect for each keyword. Collect fewer if search results are exhausted. Constraints: minimum=1, maximum=5000.

### Delivery postcode

Optional. Optional. Enter a 5-digit delivery postcode, for example 08001, or leave blank. Applying the postcode requires Playwright and Chromium in the cloud runtime. Constraints: minLength=1; maxLength=5.

## How to Use

# Amazon Product Listing Scraper (for Spain) — Usage Guide

## Overview

This template searches Amazon Spain by keyword and collects product listing data from search-result pages: ASINs, product titles, detail-page URLs, star ratings, review counts, prices, keywords, and collection timestamps.

Data source: [Amazon Spain](https://www.amazon.es/)

## Pricing

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

## Output Fields

Each result row contains:

- `Keyword`
- `ASIN`
- `Title`
- `Detail_Page_URL`
- `Star_Rating`
- `Number_of_Reviews`
- `Price`
- `Current_Time`

## Input Parameters

- **Keywords** (required): Enter up to 100 Amazon Spain product-search keywords, one per line.
- **Page Number** (optional): Enter a number from 1 to 5,000 to control how many result pages are collected.
- **Postal Code** (required): Enter the postal code for the Amazon Spain delivery context, such as `28001`.

## How to Run

1. Open the template and select **Try it** or **Start**.
2. Fill in the input fields.
3. Run the task in the cloud.
4. Review the output rows and export or process the structured data.

## Export and Reuse

Export rows to CSV, Excel, JSON, databases, or cloud storage. You can also send data to reporting or AI workflows through Octoparse APIs, including the [AgentTools API](https://www.octoparse.com/docs/en/api-reference/agenttools-api/search-templates).

Scheduling recurring runs and API access may require a paid Octoparse plan.

## Limitations

- Collects listing-result fields only; it does not return full product specifications or review text.
- `Price`, `Star_Rating`, and `Number_of_Reviews` can be empty when Amazon does not display them on a result card.
- Max 100 keywords per run; `Page Number` must be between 1 and 5,000; `Postal Code` is required.
- Amazon result order, availability, price, and delivery context can vary by postal code and collection time.

## Tips

- Use the postal code that matches the market context you want to monitor.
- Test with a small page count before expanding broad keywords to thousands of pages.
- Use `ASIN` as the primary deduplication key and for downstream product-detail lookup.

## Notes

This is a limited-access template. You can contact support@octoparse.com to get full access to the template. If you would like your own custom template, please feel free to contact us.

## 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

- [Amazon Product Details Scraper (for Spain)](https://www.octoparse.com/template/amazon-producto-detalles-scraper-asin)
- [Amazon Product Listing Scraper (for UK)](https://www.octoparse.com/template/amazon-product-listing-scraper-for-uk)
- [Amazon Product Listing Scraper (for France)](https://www.octoparse.com/template/amazon-produits-details-scraper-via-mot-cle)
- [Amazon Product Listing Scraper (for México)](https://www.octoparse.com/template/amazon-mexico-listados-scraper)
- [Amazon Product Listing Scraper (for Italy)](https://www.octoparse.com/template/crawler-elenchi-prodotti-amazon)

## Input Schema

```json
{
  "title": "Amazon Product Listing Scraper(for Spain) input",
  "description": "Input parameters configured for the current published template version.",
  "type": "object",
  "schemaVersion": 1,
  "additionalProperties": false,
  "properties": {
    "search_keywords": {
      "title": "Search keywords (up to 100)",
      "description": "Enter one keyword per item, up to 100 keywords. Each keyword may contain up to 200 characters. ScrapeNumber applies separately to each keyword.",
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1,
        "maxLength": 200
      },
      "minItems": 1,
      "maxItems": 100,
      "x-octoparse": {
        "apiEnabled": true
      }
    },
    "number_of_products_per_keyword": {
      "title": "Number of products per keyword",
      "description": "Maximum number of product records to collect for each keyword. Collect fewer if search results are exhausted.",
      "type": "integer",
      "minimum": 1,
      "maximum": 5000,
      "x-octoparse": {
        "apiEnabled": true
      }
    },
    "delivery_postcode": {
      "title": "Delivery postcode",
      "description": "Optional. Enter a 5-digit delivery postcode, for example 08001, or leave blank. Applying the postcode requires Playwright and Chromium in the cloud runtime.",
      "type": "string",
      "minLength": 1,
      "maxLength": 5,
      "x-octoparse": {
        "apiEnabled": true
      }
    }
  },
  "required": [
    "search_keywords"
  ]
}
```

## Input JSON Example

Example 1

```json
{
  "number_of_products_per_keyword": 20,
  "search_keywords": [
    "auriculares inalámbricos"
  ]
}
```

Example 2

```json
{
  "number_of_products_per_keyword": 20,
  "search_keywords": [
    "cafetera"
  ]
}
```

Example 3

```json
{
  "delivery_postcode": "28001",
  "number_of_products_per_keyword": 100,
  "search_keywords": [
    "cable",
    "iphone"
  ]
}
```

Example 4

```json
{
  "delivery_postcode": "28001",
  "number_of_products_per_keyword": 2,
  "search_keywords": [
    "wheel",
    "number"
  ]
}
```

Example 5

```json
{
  "delivery_postcode": "28001",
  "number_of_products_per_keyword": 3,
  "search_keywords": [
    "abcd",
    "car",
    "pork"
  ]
}
```


## Output Schema

```json
{
  "schemaVersion": 1,
  "type": "object",
  "properties": {
    "ASIN": {
      "type": "string",
      "description": ""
    },
    "Current_Time": {
      "type": "string",
      "description": ""
    },
    "Detail_Page_URL": {
      "type": "string",
      "description": ""
    },
    "Keyword": {
      "type": "string",
      "description": ""
    },
    "Number_of_Reviews": {
      "type": "string",
      "description": ""
    },
    "Price": {
      "type": "string",
      "description": ""
    },
    "Star_Rating": {
      "type": "string",
      "description": ""
    },
    "Title": {
      "type": "string",
      "description": ""
    }
  },
  "title": "Amazon Product Listing Scraper(for Spain) 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
{
  "ASIN": "B0BTJD6LCL",
  "Current_Time": "2026/10/30 16:58:17",
  "Detail_Page_URL": "https://www.amazon.es//Sony-WH-CH520-Auriculares-Inal%C3%A1mbricos-Bluetooth/dp/B0BTJD6LCL/ref=sr_1_1?dib=eyJ2IjoiMSJ9.vDbJjtO1dn1fP8AqoSF3BpK563Jw-3fuaW6Oross2C4_cxztbRL8VwNbSuWAmaiAt0YV-nlJGjCjgM3I-_g7bqI6m1xKiGYZ73CrB9sBK-U9LdrD-nb2zQ6jvWLRH_TExSaog12DWMgeOQbnjbwYcMLCVvLZedWnshUYM6TD2Vc7dHWxijRNGJ7gudgCLOVQgrIRFMixHD7So6ALtZIEuN5OmpfafKG_PwCdII1LLXofLyugEMOjJ0tH0jz9QglrVs2HZkcQnBrF2_tX5S9W-Qo5Gv_0AvwIqfCdC-IQsBM.7L7s-aklVNX3eX8WXmoboidaR5DFuPEdhbbkya5vUaY&dib_tag=se&keywords=auriculares%2Binal%C3%A1mbricos&qid=1793350693&sr=8-1",
  "Keyword": "auriculares inalámbricos",
  "Number_of_Reviews": "4,6",
  "Price": "22,23 €",
  "Star_Rating": "(62,1 mil)",
  "Title": "Sony WH-CH520, Auriculares de diadema inalámbricos Bluetooth, diseño ligero, 50 h de batería, carga rápida, ecualizador, llamadas nítidas, iOS y Android - Negro"
}
```

Example 2

```json
{
  "ASIN": "B0763N7WMP",
  "Current_Time": "2026/10/23 17:16:16",
  "Detail_Page_URL": "https://www.amazon.es//Cecotec-Power-Espresso-20-Inoxidable/dp/B0763N7WMP/ref=sr_1_1?dib=eyJ2IjoiMSJ9.dFGfEM3nRHkwWdjMJ5GFwDiVh5ECKNa_ROzBskpjHGVn678rdiNLC8vuRUhDxbprtOGWeyjuedwmMiiFPhB9q2FAvCVddHz0KoM7Z2r7Ug7wijDX7Pg090jf9uV5yM0-42Pb6DteIvrtj_5ku7tbIJk1x_xqFWualic9nvg89vhxSZo64_jX1Zs8wqWJQEdcYTqCfSbp4zWfe9j6RmeLslsxw-iiXkfD_Dwc9zxJ2OFIqKGd2TKxKR0ITpVapHYfwYDVYW05PGXZpRpePPJLbCEXEWczkSpEIYqstfIIEYg.2qmy5K3b6g-KZ-LYqqjUhlYkMRE7EciUI63MHPNSpkU&dib_tag=se&keywords=cafetera&qid=1792746972&sr=8-1",
  "Keyword": "cafetera",
  "Number_of_Reviews": "4,1",
  "Price": "49,50 €",
  "Star_Rating": "(14,9 mil)",
  "Title": "Cecotec Cafetera Express Manual con 20 Bares de Presión Power Espresso 20"
}
```

Example 3

```json
{
  "ASIN": "B0CVJ5WF3K",
  "Current_Time": "2026/10/16 09:57:34",
  "Detail_Page_URL": "https://www.amazon.es//Apple-iPhone-Pro-128-Reacondicionado/dp/B0CVJ5WF3K/ref=sr_1_1?dib=eyJ2IjoiMSJ9.bp2y1NJ5Ar3kKPgaIyQvNkAGBxLlorNuluEy5CdqHMS6Z4N7pig6Q29ty1N1ql-G3Q3_nX9b5CCgt7xbKeGNjvnVYVB0Wfwz-uvMDmKGG1FtZS4iog2Qo8OZetCGDt98y52nteFTEJ3OMAQ2w_Um9gGDJgYnDOT6Y_e5MNjs6wrCWSh5WC0zJQHhYflz1Acmu4IjdVwMxeFkSuTFUDPy-6g53yeHzoiytb_benf4_1mkWRH_8tE6qrocWAE1jz0pqKDPGPDKQRjT9iiT3_Lfgoy3OxOpTvdQEbF4jzIEUpI.fuew01WOetiJ0pQAAIRnf_MX_apH1diOmeOzzDJ-3iE&dib_tag=se&keywords=iphone&qid=1792115852&sbo=GW1QB%2BmqAsHTPf1jTZRSDA%3D%3D&sr=8-1",
  "Keyword": "iphone",
  "Number_of_Reviews": "3,4",
  "Price": "604,93 €",
  "Star_Rating": "(1,9 mil)",
  "Title": "Apple iPhone 15 Pro 128 GB - Titanio Azul (Reacondicionado)"
}
```

Example 4

```json
{
  "ASIN": "B0DJR8C2L7",
  "Current_Time": "2026/10/16 09:31:25",
  "Detail_Page_URL": "https://www.amazon.es//Secret-Number-Juego-L%C3%93GICA-MATEM%C3%81TICA/dp/B0DJR8C2L7/ref=sr_1_1?dib=eyJ2IjoiMSJ9.RoubW9wB4WTrEtiPPsjST4hpBHG0x3nndKgGgGovkUdsc7BfdDy4Q9yq-OTHgpEtCkYjtNQ4XSdS3R3Q-4v0fmDcF7F6NEqY1Aq3WVbQjMkJNgqOtEhbtsDc2WDoYx7iNRRIuHGi1vqbZFeKGYgn3gKCjHjkxnrvcB3UR1mrAPDsXeoRlklumirjk1MZmaMDUHLKrq-PIn4OFSVK_woJ3t3H23agOfTlSCnrJ9R2inSR4tJbmdV_6x7vURL7jjUWrTrlICC6QFBt2XPOFDuYWtnq1CFx51-7WuPtldgJgrs.ruSiSx3TMUFf38fSThbBACrrlr82aU6mYgq7dT2zyG4&dib_tag=se&keywords=number&qid=1792114280&sr=8-1",
  "Keyword": "number",
  "Number_of_Reviews": "4,5",
  "Price": "12,19 €",
  "Star_Rating": "(155)",
  "Title": "Secret Number. Juego DE LÓGICA MATEMÁTICA"
}
```

Example 5

```json
{
  "ASIN": "B089ZNG3QT",
  "Current_Time": "2026/10/15 09:31:15",
  "Detail_Page_URL": "https://www.amazon.es//gp/video/ssoredirect/?ru=https%3A%2F%2Fapp.primevideo.com%2Fdetail%3Fgti%3Damzn1.dv.gti.8cb83770-9cd1-102c-9528-ab29670c9806%26ref_%3Ddvm_src_ret_es_xx_s&page-type-id=B089ZNG3QT&ref=sr_1_2&keywords=car&dib_tag=se&dib=eyJ2IjoiMSJ9.Fe_oICZ69N3xdu2VkgLESLJVRyDDsAJGkEDF3zmWBIQ4tPGC-YUmqqPjvG59hs3ZrrL8M__8XJsIjUdKWV5XSBqGQPEC7e4MQdCSYDFKyEs5W1ORFuc7uqK7_b1ZMslhIsbJ07YGzTKmcRW7x4o1Ivg1ztkQBZalGWDGO3v5RvtoSD27TywoIoGKp0jXgy6Qzx19suM2VAkEevFcl8ELj03ttZYxFNwa8gOr0V8xVAlXE-vIdxt6BtTSFwOjFyXy0Eb-nrprxNjnHblXxBSsxuF4EXjZ6cpNv8G9_-inaU4.lbAGygRxW4W15FMPzocraSc83s5mKCWhm97dKhoCJf8&qid=1792027870&sr=8-2",
  "Keyword": "car",
  "Number_of_Reviews": "4,5",
  "Price": "3,99 €",
  "Star_Rating": "(736)",
  "Title": "Cars"
}
```

## 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-espana-listados-scraper",
  "taskName": "Amazon Product Listing Scraper(for Spain)",
  "parameters": "{\"number_of_products_per_keyword\":20,\"search_keywords\":[\"auriculares inalámbricos\"]}"
}
```

## Python Example

```python
import json
import requests

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

parameters = json.loads("{\"number_of_products_per_keyword\":20,\"search_keywords\":[\"auriculares inalámbricos\"]}")

response = requests.post(
    f"{OPENAPI_BASE}/api/agentTools/executeTask",
    headers={
        "Authorization": f"Bearer {ACCESS_TOKEN}",
        "Content-Type": "application/json",
    },
    json={
        "templateName": "amazon-espana-listados-scraper",
        "taskName": "Amazon Product Listing Scraper(for Spain)",
        "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-espana-listados-scraper",
  "taskName": "Amazon Product Listing Scraper(for Spain)",
  "parameters": "{\"number_of_products_per_keyword\":20,\"search_keywords\":[\"auriculares inalámbricos\"]}"
}
JSON
```

## MCP Setup

Connect an MCP-compatible AI client to `https://mcp.octoparse.com` using browser OAuth or an Octoparse API key. Find `amazon-espana-listados-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-espana-listados-scraper.json)
- [Manifest](https://www.octoparse.com/templates/amazon-espana-listados-scraper-manifest.json)