# Amazon Kindle Rankings Scraper (Japan)

Template for extracting book information (departures, prices, etc.) from Amazon Kindle rankings via URLs.

- Template page: [https://www.octoparse.com/template/amazon-jp-kindle-rankings-scraper](https://www.octoparse.com/template/amazon-jp-kindle-rankings-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 listing pages.

## Output

The current workflow extracts 10 fields, including `カテゴリー`, `カテゴリーURL`, `タイトル名`, `ランキング`, `価格`, `出版社名`, `商品URL`, `発売日`, `著者名`, `言語`.

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

## Input

### URL (up to 1000 per run)

Optional. URL (up to 1000 per run) Constraints: minItems=1; maxItems=1000; items.minLength=1; items.maxLength=10000.

## How to Use

# Amazon Kindle Rankings Scraper (Japan) – Usage Guide

## Overview

Collects book information (rankings, prices, etc.) from Amazon Kindle ranking pages via URLs.

- Source: [Amazon.co.jp](https://www.amazon.co.jp/)
- Pricing: currently no per-line charge
- Run locally or in the cloud

## Input

- **URL (up to 1000 per run)** (optional): enter one or more values, one per line.

Use valid Amazon Kindle ranking listing URLs.

## Output Fields

The template returns these fields:

- カテゴリー
- カテゴリーURL
- ランキング
- 価格
- タイトル名
- 著者名
- 言語
- 出版社名
- 発売日
- 商品URL

## How to Use

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

## Run, Schedule, and Export

- Run this template locally or in the cloud.
- Schedule recurring runs in Octoparse.
- Export rows to CSV, Excel, JSON, databases, or cloud storage.
- Send data to reporting or AI workflows through Octoparse APIs:
  - Octoparse OpenAPI
  - [AgentTools API](https://www.octoparse.com/docs/en/api-reference/agenttools-api/search-templates)

Scheduling and API access may require a paid Octoparse plan. For local scheduled runs, keep your computer and Octoparse open.

## Limitations

- This template collects only the listing fields listed in **Output Fields**; it does not add data that Amazon does not display.
- Fields such as 出版社名, 発売日, and 商品URL 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 the task.
- Use the most specific valid URL (up to 1000 per run) to reduce unrelated or duplicate records.
- When available, use a stable URL or identifier from the output fields as the deduplication key.

## 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](https://www.octoparse.com/template/amazon-japan-product-scraper)
- [Amazon Japan Product Details Scraper](https://www.octoparse.com/template/amazon-japan-product-details-scraper)
- [Amazon Japan Product Scraper by Asin](https://www.octoparse.com/template/amazon-japan-scraper-by-asin)
- [Google Maps Store Listing Scraper (Japan)](https://www.octoparse.com/template/google-maps-store-listing-scraper)
- [Google Scholar Article Scraper (for Japan)](https://www.octoparse.com/template/google-scholar-jp-article-scraper)

## Input Schema

```json
{
  "title": "Amazon Kindle Rankings Scraper (Japan) input",
  "description": "Input parameters configured for the current published template version.",
  "type": "object",
  "schemaVersion": 1,
  "additionalProperties": false,
  "properties": {
    "uRL": {
      "title": " URL (up to 1000 per run)",
      "description": " URL (up to 1000 per run)",
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1,
        "maxLength": 10000
      },
      "minItems": 1,
      "maxItems": 1000,
      "x-octoparse": {
        "apiEnabled": true
      }
    }
  },
  "required": []
}
```

## Input JSON Example

Example 1

```json
{
  "uRL": [
    "https://www.amazon.co.jp/gp/bestsellers/digital-text/2430737051/ref=zg_bs_nav_digital-text_3_2293143051"
  ]
}
```


## Output Schema

```json
{
  "schemaVersion": 1,
  "type": "object",
  "properties": {
    "カテゴリー": {
      "type": "string",
      "description": ""
    },
    "カテゴリーURL": {
      "type": "string",
      "description": ""
    },
    "タイトル名": {
      "type": "string",
      "description": ""
    },
    "ランキング": {
      "type": "string",
      "description": ""
    },
    "価格": {
      "type": "string",
      "description": ""
    },
    "出版社名": {
      "type": "string",
      "description": ""
    },
    "商品URL": {
      "type": "string",
      "description": ""
    },
    "発売日": {
      "type": "string",
      "description": ""
    },
    "著者名": {
      "type": "string",
      "description": ""
    },
    "言語": {
      "type": "string",
      "description": ""
    }
  },
  "title": "Amazon Kindle Rankings Scraper (Japan) 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
{
  "カテゴリー": "Amazon.co.jp Best Sellers: The most popular items in Josei Comics",
  "カテゴリーURL": "https://www.amazon.co.jp/gp/bestsellers/digital-text/2430737051/ref=zg_bs_nav_digital-text_3_2293143051",
  "タイトル名": "          ながたんと青と－いちかの料理帖－（１６） (Ｋｉｓｓコミックス)             ",
  "ランキング": "#3",
  "価格": "USD 3.75",
  "出版社名": "講談社",
  "商品URL": "https://www.amazon.co.jp/-/en/%E7%A3%AF%E8%B0%B7%E5%8F%8B%E7%B4%80-ebook/dp/B0HLKKVFKM/ref=zg_bs_g_2430737051_d_sccl_3/355-0770001-6768227?psc=1",
  "発売日": "October 13, 2026",
  "著者名": "磯谷友紀(Author)",
  "言語": "Japanese"
}
```

## 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-jp-kindle-rankings-scraper",
  "taskName": "Amazon Kindle Rankings Scraper (Japan)",
  "parameters": "{\"uRL\":[\"https://www.amazon.co.jp/gp/bestsellers/digital-text/2430737051/ref=zg_bs_nav_digital-text_3_2293143051\"]}"
}
```

## Python Example

```python
import json
import requests

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

parameters = json.loads("{\"uRL\":[\"https://www.amazon.co.jp/gp/bestsellers/digital-text/2430737051/ref=zg_bs_nav_digital-text_3_2293143051\"]}")

response = requests.post(
    f"{OPENAPI_BASE}/api/agentTools/executeTask",
    headers={
        "Authorization": f"Bearer {ACCESS_TOKEN}",
        "Content-Type": "application/json",
    },
    json={
        "templateName": "amazon-jp-kindle-rankings-scraper",
        "taskName": "Amazon Kindle Rankings Scraper (Japan)",
        "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-jp-kindle-rankings-scraper",
  "taskName": "Amazon Kindle Rankings Scraper (Japan)",
  "parameters": "{\"uRL\":[\"https://www.amazon.co.jp/gp/bestsellers/digital-text/2430737051/ref=zg_bs_nav_digital-text_3_2293143051\"]}"
}
JSON
```

## MCP Setup

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