# Amazon Best Sellers Scraper

Scrape the top 100 most popular items on Amazon from any category. Could be used on any domains.

- Template page: [https://www.octoparse.com/template/amazon-best-sellers-scraper](https://www.octoparse.com/template/amazon-best-sellers-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 general web pages.

## Output

The current workflow extracts 13 fields, including `Brand`, `Category`, `Name`, `Original_URL`, `Picture`, `Platform`, `Position`, `Price`, `Ratings`, `Reviews_link`, `Stars`, `Url`, `error`.

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

## Input

### URL List (up to 10,000)

Required. URL List Constraints: minItems=1; maxItems=10000; items.minLength=1; items.maxLength=10000.

## How to Use

### Input

- **URL List** (Required) — Up to 10,000 entries per run.  
  Provide Amazon Best Sellers listing page URLs (e.g., `https://www.amazon.com/gp/bestsellers/` or any subcategory page).

### How to Use

1. Open Amazon Best Sellers Scraper and click **Try it!**.
2. Fill in **URL List** with one or more Amazon Best Sellers page URLs.
3. Run the task locally or in the cloud.
4. Export the output. Each row contains the following fields:

```json
{
  "Original_URL": "https://www.amazon.es/-/en/gp/bestsellers/mobile-apps/ref=zg_bs_nav_mobile-apps_0",
  "Category": "Apps & Games (Current)",
  "Position": "#1",
  "Name": "Download Manager for Fire TV",
  "Url": "https://www.amazon.es/-/en/dp/B01NAT74Q5/ref=zg_bs_g_mobile-apps_d_sccl_1/261-8806125-1920939?psc=1",
  "Brand": "Tapbytes, LLC",
  "Stars": "3.8 out of 5 stars",
  "Ratings": "3,720",
  "Reviews_link": "https://www.amazon.es/-/en/product-reviews/B01NAT74Q5/ref=zg_bs_g_mobile-apps_d_sccl_1_cr/261-8806125-1920939",
  "Platform": null,
  "Price": "€0.93",
  "Picture": "https://images-eu.ssl-images-amazon.com/images/I/4198okEsLZL._AC_UL600_SR600,400_.png",
  "error": null
}
```

### Tips

- Test one representative URL before running a large batch.
- Keep `Original_URL` in the export so every row can be traced back to its input page.

### Pricing

This template is currently **free of charge** and has no per-line usage fee. Octoparse plan or resource limits may still apply.

## 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 Best Sellers Scraper (by Category)](https://www.octoparse.com/template/amazon-best-sellers-scraper-by-category)
- [Best Buy Reviews Scraper](https://www.octoparse.com/template/best-buy-reviews-scraper)
- [Amazon Scraper](https://www.octoparse.com/template/amazon-product-scraper-by-keywords)
- [Amazon Japan Product Scraper](https://www.octoparse.com/template/amazon-japan-product-scraper)

## Input Schema

```json
{
  "title": "Amazon Best Sellers Scraper input",
  "description": "Input parameters configured for the current published template version.",
  "type": "object",
  "schemaVersion": 1,
  "additionalProperties": false,
  "properties": {
    "uRL_List": {
      "title": "URL List (up to 10,000)",
      "description": "URL List",
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1,
        "maxLength": 10000
      },
      "minItems": 1,
      "maxItems": 10000,
      "x-octoparse": {
        "apiEnabled": true
      }
    }
  },
  "required": [
    "uRL_List"
  ]
}
```

## Input JSON Example

Example 1

```json
{
  "uRL_List": [
    "https://www.amazon.com/gp/bestsellers/kitchen/367142011"
  ]
}
```

Example 2

```json
{
  "uRL_List": [
    "https://www.amazon.com/gp/bestsellers/kitchen/367142011"
  ]
}
```

Example 3

```json
{
  "uRL_List": [
    "https://www.amazon.com/gp/bestsellers/kitchen/367142011"
  ]
}
```

Example 4

```json
{
  "uRL_List": [
    "https://www.amazon.es/-/en/gp/bestsellers/mobile-apps/ref=zg_bs_nav_mobile-apps_0"
  ]
}
```

Example 5

```json
{
  "uRL_List": [
    "https://www.amazon.es/-/en/gp/bestsellers/mobile-apps/ref=zg_bs_nav_mobile-apps_0"
  ]
}
```


## Output Schema

```json
{
  "schemaVersion": 1,
  "type": "object",
  "properties": {
    "Brand": {
      "type": "string",
      "description": ""
    },
    "Category": {
      "type": "string",
      "description": ""
    },
    "Name": {
      "type": "string",
      "description": ""
    },
    "Original_URL": {
      "type": "string",
      "description": ""
    },
    "Picture": {
      "type": "string",
      "description": ""
    },
    "Platform": {
      "type": "string",
      "description": ""
    },
    "Position": {
      "type": "string",
      "description": ""
    },
    "Price": {
      "type": "string",
      "description": ""
    },
    "Ratings": {
      "type": "string",
      "description": ""
    },
    "Reviews_link": {
      "type": "string",
      "description": ""
    },
    "Stars": {
      "type": "string",
      "description": ""
    },
    "Url": {
      "type": "string",
      "description": ""
    },
    "error": {
      "type": "string",
      "description": ""
    }
  },
  "title": "Amazon Best Sellers 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
{
  "Brand": "",
  "Category": "Coffee Cups & Mugs\n(Current)",
  "Name": "NOVA CERAMICS Coffee Tumbler – Travel Mug - On the Go Coffee Mug – Microwave & Dishwasher Safe Green Coffee Tumbler - Gifts For Women Men Him Her – 16oz – Monsoon",
  "Original_URL": "https://www.amazon.com/gp/bestsellers/kitchen/367142011",
  "Picture": "https://images-na.ssl-images-amazon.com/images/I/71wbHduX9UL._AC_UL600_SR600,400_.jpg",
  "Platform": "",
  "Position": "#2",
  "Price": "$29.74",
  "Ratings": "3,385",
  "Reviews_link": "https://www.amazon.com/product-reviews/B0DCGLKZCQ/ref=zg_bs_g_367142011_d_sccl_2_cr/130-7541311-9902309",
  "Stars": "4.3 out of 5 stars",
  "Url": "https://www.amazon.com/NOVA-CERAMICS-Coffee-Tumbler-Dishwasher/dp/B0DCGLKZCQ/ref=zg_bs_g_367142011_d_sccl_2/130-7541311-9902309?psc=1",
  "error": ""
}
```

Example 2

```json
{
  "Brand": "",
  "Category": "Coffee Cups & Mugs\n(Current)",
  "Name": "Silver Buffalo Peanuts Snoopy and Woodstock, Ceramic Camper Mug, 20oz | Get Cozy, 0.59 Liters",
  "Original_URL": "https://www.amazon.com/gp/bestsellers/kitchen/367142011",
  "Picture": "https://images-na.ssl-images-amazon.com/images/I/71GOZ1aCsGL._AC_UL600_SR600,400_.jpg",
  "Platform": "",
  "Position": "#1",
  "Price": "$7.99",
  "Ratings": "4,081",
  "Reviews_link": "https://www.amazon.com/product-reviews/B09LRKRMF2/ref=zg_bs_g_367142011_d_sccl_1_cr/147-4915069-9534437",
  "Stars": "4.8 out of 5 stars",
  "Url": "https://www.amazon.com/Silver-Buffalo-Peanuts-Woodstock-Ceramic/dp/B09LRKRMF2/ref=zg_bs_g_367142011_d_sccl_1/147-4915069-9534437?psc=1",
  "error": ""
}
```

Example 3

```json
{
  "Brand": "",
  "Category": "Coffee Cups & Mugs\n(Current)",
  "Name": "HydroJug Coffee Traveler 20oz Ceramic-Lined Mug with Handle, Brown Leopard | Double-wall insulated tumbler, hot 6 hrs/cold 12 hrs, leak-resistant, flip-top lid, ambidextrous, BPA-free, dishwasher safe",
  "Original_URL": "https://www.amazon.com/gp/bestsellers/kitchen/367142011",
  "Picture": "https://images-na.ssl-images-amazon.com/images/I/61CMgxsYhyL._AC_UL600_SR600,400_.jpg",
  "Platform": "",
  "Position": "#3",
  "Price": "$34.99",
  "Ratings": "1,222",
  "Reviews_link": "https://www.amazon.com/product-reviews/B0FXYGTGWS/ref=zg_bs_g_367142011_d_sccl_3_cr/140-1200160-2562635",
  "Stars": "4.6 out of 5 stars",
  "Url": "https://www.amazon.com/HydroJug-Coffee-Traveler-Leak-Resistant-Ceramic-Lined/dp/B0FXYGTGWS/ref=zg_bs_g_367142011_d_sccl_3/140-1200160-2562635?psc=1",
  "error": ""
}
```

Example 4

```json
{
  "Brand": "Vixapps",
  "Category": "Apps & Games\n(Current)",
  "Name": "Smarters Pro IPTV",
  "Original_URL": "https://www.amazon.es/-/en/gp/bestsellers/mobile-apps/ref=zg_bs_nav_mobile-apps_0",
  "Picture": "https://images-eu.ssl-images-amazon.com/images/I/71F7aVz2O+L._AC_UL600_SR600,400_.png",
  "Platform": "",
  "Position": "#1",
  "Price": "€3.99",
  "Ratings": "4",
  "Reviews_link": "https://www.amazon.es/-/en/product-reviews/B0HR7CYVHK/ref=zg_bs_g_mobile-apps_d_sccl_1_cr/525-1810005-3475132",
  "Stars": "3.4 out of 5 stars",
  "Url": "https://www.amazon.es/-/en/dp/B0HR7CYVHK/ref=zg_bs_g_mobile-apps_d_sccl_1/525-1810005-3475132?psc=1",
  "error": ""
}
```

Example 5

```json
{
  "Brand": "Vixapps",
  "Category": "Apps & Games\n(Current)",
  "Name": "Smarters Pro IPTV",
  "Original_URL": "https://www.amazon.es/-/en/gp/bestsellers/mobile-apps/ref=zg_bs_nav_mobile-apps_0",
  "Picture": "https://images-eu.ssl-images-amazon.com/images/I/71F7aVz2O+L._AC_UL600_SR600,400_.png",
  "Platform": "",
  "Position": "#1",
  "Price": "€3.99",
  "Ratings": "4",
  "Reviews_link": "https://www.amazon.es/-/en/product-reviews/B0HR7CYVHK/ref=zg_bs_g_mobile-apps_d_sccl_1_cr/520-9414042-9598242",
  "Stars": "3.4 out of 5 stars",
  "Url": "https://www.amazon.es/-/en/dp/B0HR7CYVHK/ref=zg_bs_g_mobile-apps_d_sccl_1/520-9414042-9598242?psc=1",
  "error": ""
}
```

## 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-best-sellers-scraper",
  "taskName": "Amazon Best Sellers Scraper",
  "parameters": "{\"uRL_List\":[\"https://www.amazon.com/gp/bestsellers/kitchen/367142011\"]}"
}
```

## Python Example

```python
import json
import requests

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

parameters = json.loads("{\"uRL_List\":[\"https://www.amazon.com/gp/bestsellers/kitchen/367142011\"]}")

response = requests.post(
    f"{OPENAPI_BASE}/api/agentTools/executeTask",
    headers={
        "Authorization": f"Bearer {ACCESS_TOKEN}",
        "Content-Type": "application/json",
    },
    json={
        "templateName": "amazon-best-sellers-scraper",
        "taskName": "Amazon Best Sellers 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-best-sellers-scraper",
  "taskName": "Amazon Best Sellers Scraper",
  "parameters": "{\"uRL_List\":[\"https://www.amazon.com/gp/bestsellers/kitchen/367142011\"]}"
}
JSON
```

## MCP Setup

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