# Amazon Product Scraper by Keywords

Scrape product title, price, ASIN, rating star, etc from Amazon by zip code and keywords.

- Template page: [https://www.octoparse.com/template/amazon-produkt-scraper-mit-schluesselwoerter](https://www.octoparse.com/template/amazon-produkt-scraper-mit-schluesselwoerter)
- 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, detail pages.

## Output

The current workflow extracts 15 fields, including `ASIN`, `Adresse`, `Aktueller_Preis`, `Anzahl_der_Bewertungen`, `Badge`, `Bild`, `Gratis_Lieferung`, `Kundenbewertung`, `Produktname`, `Produktseite`, `Rezensionsseite`, `Schlüsselwort`, `Seite`, `Ursprünglicher_Preis`, `Webseite`.

## 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 Zip Code, Keywords (up to 5) and start the template in local or cloud mode.
- **Flexible export:** review and export results as CSV, Excel, or JSON.

## Input

### Zip Code

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

### Keywords (up to 5)

Required. Geben Sie bitte die Schlüsselwörter zur Suche nach Ihren gewünschten Sachen ein. Constraints: minItems=1; maxItems=5; items.minLength=1; items.maxLength=5000.

## How to Use

# Amazon Product Scraper by Keywords

Collect Amazon.de product search-result data by **Zip Code** and **Keywords (up to 5)**. The returned rows include product title, price, ASIN, ratings and review count, product and review links, badges, current and original price, image, free-delivery date, source website, address, keyword, and page.

## Data Source

- [Amazon](https://amazon.de/)

## Input

- **Zip Code** (required): Enter the Zip Code requested by the template.
- **Keywords (up to 5)** (required): Enter one or more values, one per line.

## How to Use

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

## Export and Scheduling

- Run locally with the Octoparse desktop app; keep your computer and Octoparse open while the task runs.
- Export rows to CSV, Excel, JSON, databases, or cloud storage, or send them to reporting and AI workflows through Octoparse APIs.
- Schedule recurring runs and reuse collected data through Octoparse OpenAPI or the [AgentTools API](https://www.octoparse.com/docs/en/api-reference/agenttools-api/search-templates).
- Scheduling and API access may require a paid Octoparse plan.

## Pricing

- Currently no per-line charge.
- Octoparse plan or resource limits may still apply.

## Limitations

- Collects search-result or listing fields, not complete detail-page data; use a detail-page template when deeper record data is required.
- Fields such as `Ursprünglicher_Preis`, `Bild`, and `Gratis_Lieferung` can be empty when the source record does not provide them.

## Tips

- Start with one or a few inputs and review the returned rows before scaling.
- Use the most specific valid Zip Code to reduce unrelated or duplicate records.
- Use a stable URL or identifier, for example an ASIN or product page URL, as the deduplication key when available.

## 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 Japan Product Scraper by Asin](https://www.octoparse.com/template/amazon-japan-scraper-by-asin)
- [Google Maps Listings Scraper (by Keywords)](https://www.octoparse.com/template/google-maps-scraper-listing-page-by-keyword)
- [Reddit Post Scraper (by Keywords)](https://www.octoparse.com/template/reddit-post-scraper-by-keywords)
- [Google Job Scraper (by Keywords)](https://www.octoparse.com/template/google-job-search)
- [Foursquare Scraper (by Keywords)](https://www.octoparse.com/template/foursquare-scraper-by-keywords)

## Input Schema

```json
{
  "title": "Amazon Product Scraper by Keywords input",
  "description": "Input parameters configured for the current published template version.",
  "type": "object",
  "schemaVersion": 1,
  "additionalProperties": false,
  "properties": {
    "zip_Code": {
      "title": "Zip Code",
      "description": "Postleitzahl",
      "type": "string",
      "minLength": 1,
      "maxLength": 100,
      "x-octoparse": {
        "apiEnabled": true
      }
    },
    "keywords": {
      "title": "Keywords (up to 5)",
      "description": "Geben Sie bitte die Schlüsselwörter zur Suche nach Ihren gewünschten Sachen ein.",
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1,
        "maxLength": 5000
      },
      "minItems": 1,
      "maxItems": 5,
      "x-octoparse": {
        "apiEnabled": false
      }
    }
  },
  "required": [
    "zip_Code",
    "keywords"
  ]
}
```

## Input JSON Example

Example 1

```json
{
  "keywords": [
    "Stockings"
  ],
  "zip_Code": "10243"
}
```

Example 2

```json
{
  "keywords": [
    "Stockings"
  ],
  "zip_Code": "10243"
}
```


## Output Schema

```json
{
  "schemaVersion": 1,
  "type": "object",
  "properties": {
    "ASIN": {
      "type": "string",
      "description": ""
    },
    "Adresse": {
      "type": "string",
      "description": ""
    },
    "Aktueller_Preis": {
      "type": "string",
      "description": ""
    },
    "Anzahl_der_Bewertungen": {
      "type": "string",
      "description": ""
    },
    "Badge": {
      "type": "string",
      "description": ""
    },
    "Bild": {
      "type": "string",
      "description": ""
    },
    "Gratis_Lieferung": {
      "type": "string",
      "description": ""
    },
    "Kundenbewertung": {
      "type": "string",
      "description": ""
    },
    "Produktname": {
      "type": "string",
      "description": ""
    },
    "Produktseite": {
      "type": "string",
      "description": ""
    },
    "Rezensionsseite": {
      "type": "string",
      "description": ""
    },
    "Schlüsselwort": {
      "type": "string",
      "description": ""
    },
    "Seite": {
      "type": "string",
      "description": ""
    },
    "Ursprünglicher_Preis": {
      "type": "string",
      "description": ""
    },
    "Webseite": {
      "type": "string",
      "description": ""
    }
  },
  "title": "Amazon Product Scraper by Keywords 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": "B0D5HNK63L",
  "Adresse": "\n                   Berlin 10243‌\n                ",
  "Aktueller_Preis": "€7.25",
  "Anzahl_der_Bewertungen": "(980)  ",
  "Badge": "Black Friday Big Deal",
  "Bild": "https://m.media-amazon.com/images/I/61QI4ZrljCL._AC_UL320_.jpg",
  "Gratis_Lieferung": "",
  "Kundenbewertung": "4.3 out of 5 stars",
  "Produktname": "RSLOVE",
  "Produktseite": "https://amazon.de/-/en/RSLOVE-Suspender-Stockings-Non-Slip-Silicone/dp/B0D5HNK63L/ref=sr_1_1?crid=3RWP84Z6SFIZW&dib=eyJ2IjoiMSJ9.sJCErU2u6LIPpDJL0mPpzfekepps59wSKu_bwZvqn6XWvmx9AYZsVGg0LwRt4rgwY_55eYxsjXhIEu7-jgGtsauu2MvPhICjiIUVONSGunffMqP2vzwF-hIP0yx0zgy2DDE5hSAoaauaP4kapMyCr8yXundDWg47oamobq2p9XhRWNwOUmO58ncGMwnrLABR289tD32Pr4w0mwOv6qbEZdeZnLaCCHs-SLwqoxbBSDWP9i_9bjkr27BY5hNY2W3GlCjCiHUOvFINME27ULmBjbPD98Jx6AmQVZgKG3psBYo.wfxkbIGRE9qYSVm2eaWPk5WycygSJTrsvB8rcMTenW4&dib_tag=se&keywords=Stockings&qid=1795068319&sprefix=stockings%2Caps%2C235&sr=8-1",
  "Rezensionsseite": "https://www.amazon.de/-/en/RSLOVE-Suspender-Stockings-Non-Slip-Silicone/dp/B0D5HNK63L/ref=sr_1_1?crid=3RWP84Z6SFIZW&dib=eyJ2IjoiMSJ9.sJCErU2u6LIPpDJL0mPpzfekepps59wSKu_bwZvqn6XWvmx9AYZsVGg0LwRt4rgwY_55eYxsjXhIEu7-jgGtsauu2MvPhICjiIUVONSGunffMqP2vzwF-hIP0yx0zgy2DDE5hSAoaauaP4kapMyCr8yXundDWg47oamobq2p9XhRWNwOUmO58ncGMwnrLABR289tD32Pr4w0mwOv6qbEZdeZnLaCCHs-SLwqoxbBSDWP9i_9bjkr27BY5hNY2W3GlCjCiHUOvFINME27ULmBjbPD98Jx6AmQVZgKG3psBYo.wfxkbIGRE9qYSVm2eaWPk5WycygSJTrsvB8rcMTenW4&dib_tag=se&keywords=Stockings&qid=1795068319&sprefix=stockings%2Caps%2C235&sr=8-1#customerReviews",
  "Schlüsselwort": "Stockings",
  "Seite": "1",
  "Ursprünglicher_Preis": "€13.99",
  "Webseite": "Amazon.de"
}
```

Example 2

```json
{
  "ASIN": "B0F6YC76F9",
  "Adresse": "\n                   Berlin 10243‌\n                ",
  "Aktueller_Preis": "USD 8.52",
  "Anzahl_der_Bewertungen": "(361)  ",
  "Badge": "Amazon's ",
  "Bild": "https://m.media-amazon.com/images/I/6177mdb+dWL._AC_UL320_.jpg",
  "Gratis_Lieferung": "",
  "Kundenbewertung": "4.1 out of 5 stars",
  "Produktname": "Women's Sexy Hold-Up Stockings - Sexy Lace Stay Up Suspender Stockings with Non-Slip Silicone",
  "Produktseite": "https://amazon.de/-/en/LUSLOVE-Womens-Sexy-Hold-Up-Stockings/dp/B0F6YC76F9/ref=sr_1_7?dib=eyJ2IjoiMSJ9.uOvFyfgt8rg_vyaMwsSPFrjUpEwQbkcnG1KiU6eWA7fHwj-GaQOSFtNLBEtflUgtYmWmYATW4P5PGQi1zUZJ639brxcEeS0vnTMAIfOXoF-DnHksW22FWi9rRqI_fY2OUfQGSgrwMGEvuOI3Ya0ZvsABWmDDPM4t5RUeWGLCM7xwb9IUZ9lMqJferqdClSMBk00Qi0JR040_v5vA-VTW4lKg4q0o44_cPK7aO9ITdu6lCyQ5VxP0kZL0brj-yb_xmy1yF6MHi26YwVuU1Q48BJsfa6nQv_kUeOq5aZdqGTM.3Aq2wmEndgQiWwVMx8AA5pss0Z4fffzEUsSh_Aks160&dib_tag=se&keywords=Stockings&qid=1794821518&sr=8-7",
  "Rezensionsseite": "https://www.amazon.de/-/en/LUSLOVE-Womens-Sexy-Hold-Up-Stockings/dp/B0F6YC76F9/ref=sr_1_7?dib=eyJ2IjoiMSJ9.uOvFyfgt8rg_vyaMwsSPFrjUpEwQbkcnG1KiU6eWA7fHwj-GaQOSFtNLBEtflUgtYmWmYATW4P5PGQi1zUZJ639brxcEeS0vnTMAIfOXoF-DnHksW22FWi9rRqI_fY2OUfQGSgrwMGEvuOI3Ya0ZvsABWmDDPM4t5RUeWGLCM7xwb9IUZ9lMqJferqdClSMBk00Qi0JR040_v5vA-VTW4lKg4q0o44_cPK7aO9ITdu6lCyQ5VxP0kZL0brj-yb_xmy1yF6MHi26YwVuU1Q48BJsfa6nQv_kUeOq5aZdqGTM.3Aq2wmEndgQiWwVMx8AA5pss0Z4fffzEUsSh_Aks160&dib_tag=se&keywords=Stockings&qid=1794821518&sr=8-7#customerReviews",
  "Schlüsselwort": "Stockings",
  "Seite": "1",
  "Ursprünglicher_Preis": "USD 13.28",
  "Webseite": "Amazon.de"
}
```

## 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-produkt-scraper-mit-schluesselwoerter",
  "taskName": "Amazon Product Scraper by Keywords",
  "parameters": "{\"keywords\":[\"Stockings\"],\"zip_Code\":\"10243\"}"
}
```

## Python Example

```python
import json
import requests

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

parameters = json.loads("{\"keywords\":[\"Stockings\"],\"zip_Code\":\"10243\"}")

response = requests.post(
    f"{OPENAPI_BASE}/api/agentTools/executeTask",
    headers={
        "Authorization": f"Bearer {ACCESS_TOKEN}",
        "Content-Type": "application/json",
    },
    json={
        "templateName": "amazon-produkt-scraper-mit-schluesselwoerter",
        "taskName": "Amazon Product Scraper by Keywords",
        "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-produkt-scraper-mit-schluesselwoerter",
  "taskName": "Amazon Product Scraper by Keywords",
  "parameters": "{\"keywords\":[\"Stockings\"],\"zip_Code\":\"10243\"}"
}
JSON
```

## MCP Setup

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