Pangolinfo Amazon Scraper: Products + Keywords + Reviews + Categories

Scrape Amazon as JSON — products, keywords, reviews, BSR. 13 regions. Anti-bot. 60 free credits. Claude Code, Cursor, LangChain.

Audits

Pass

ClawScanPass

Agentic behavior and permission review.

Static analysisPass

Pattern checks against bundled files.

VirusTotalPass

Multi-engine malware detections and file reputation.

Install

openclaw skills install pangolinfo-amazon-scraper

Pangolinfo Amazon Scraper

Get Amazon product data in under a minute.

Use this skill when you want to:

get price, rating, and BSR from an ASIN
search Amazon keywords and compare results
extract critical reviews and summarize complaints
track seller storefronts, best sellers, and product variants

🎁 New users get 60 free credits. Enough for real product lookups, keyword tests, and review workflows before upgrading. 👉 Get your free API key — about 30 seconds.

First win in 30 seconds

Get your free API key: https://tool.pangolinfo.com/?referrer=clawhub_amz
Set the environment variable:

export PANGOLINFO_API_KEY="pgl_xxx"

Run your first lookup:

python3 scripts/pangolinfo.py --asin B0DYTF8L2W --site amz_us

If you see fields like these, the skill is working:

title
price
star
bestSellersRank

What to do next

Check your own product

python3 scripts/pangolinfo.py --asin YOUR_ASIN --site amz_us

Search a keyword

python3 scripts/pangolinfo.py --q "wireless mouse" --site amz_us

Find top complaints from reviews

python3 scripts/pangolinfo.py --asin YOUR_ASIN --mode review --filter-star critical --pages 1

First-time setup (agent instructions)

If PANGOLINFO_API_KEY is not set, the agent MUST guide the user as follows and stop there. Do not attempt the API call without credentials.

"This skill needs a free Pangolinfo API key.

Visit https://tool.pangolinfo.com/?referrer=clawhub_amz

Sign up and copy your API key

Run: export PANGOLINFO_API_KEY='pgl_xxx'

Verify: python3 scripts/pangolinfo.py --auth-only

Then ask me to retry your request."

The API key does not expire. For interactive setup, see references/setup-guide.md.

What this skill can do

This skill returns structured Amazon data across 13 marketplaces (US/UK/CA/DE/FR/JP/IT/ES/AU/MX/SA/AE/BR). CAPTCHA and anti-bot handling run in the cloud.

🎯 Capabilities (9 Parsers)

Parser	Use case	Quick example
`amzProductDetail` (default)	ASIN details: price, BSR, rating, attributes	`--asin B0DYTF8L2W`
`amzKeyword`	Keyword search (organic + sponsored rank)	`--q "wireless mouse"`
`amzProductOfCategory`	Category listings	`--content <nodeID> --parser amzProductOfCategory`
`amzProductOfSeller`	Seller storefront products	`--content <sellerID> --parser amzProductOfSeller`
`amzBestSellers`	BSR rankings by category	`--content electronics --parser amzBestSellers`
`amzNewReleases`	New releases by category	`--content electronics --parser amzNewReleases`
`amzFollowSeller`	Follow seller updates (separate endpoint)	`--asin B0DYTF8L2W --parser amzFollowSeller`
`amzVariantAsin`	Get variant ASINs (separate endpoint)	`--asin B0G4QPYK4Z --parser amzVariantAsin`
`amzReviewV2`	Product reviews with star/sort filters	`--asin B0DYTF8L2W --mode review --filter-star critical`

The script auto-infers parser from input (ASIN → amzProductDetail, keyword → amzKeyword).

🌍 Supported Marketplaces (13 regions)

Code	Domain	Code	Domain
`amz_us`	amazon.com	`amz_jp`	amazon.co.jp
`amz_uk`	amazon.co.uk	`amz_it`	amazon.it
`amz_ca`	amazon.ca	`amz_es`	amazon.es
`amz_de`	amazon.de	`amz_au`	amazon.com.au
`amz_fr`	amazon.fr	`amz_mx`	amazon.com.mx
`amz_br`	amazon.com.br	`amz_sa`	amazon.sa
`amz_ae`	amazon.ae

Default: amz_us. Pass via --site amz_uk etc.

💰 Credit Consumption

Operation	Credits
Product / keyword / category / seller / bestsellers (`--format json`)	1
Same with `--format rawHtml` or `markdown`	0.75
Follow Seller	1
Variant ASIN	1
Review page (`--mode review`)	5 per page

→ 60 free credits = 60 product lookups, OR 12 review pages, OR 80 raw HTML fetches. → Credits are charged only on success (api_code: 0).

📤 Sample Output

Success (stdout):

{
  "success": true,
  "task_id": "02b3e90810f0450ca6d41244d6009d0f",
  "url": "https://www.amazon.com/dp/B0DYTF8L2W",
  "metadata": {
    "executionTime": 1791,
    "parserType": "amzProductDetail",
    "parsedAt": "2026-04-27T06:42:01.861Z"
  },
  "results": [
    {
      "asin": "B0DYTF8L2W",
      "title": "Sweetcrispy Convertible Sectional Sofa Couch...",
      "price": "...",
      "star": "4.4",
      "rating": "(22)",
      "bestSellersRank": "#2,329,042 in Home & Kitchen",
      "reviews": [ /* ... */ ],
      "aiReviewsSummary": { /* ... */ }
    }
  ],
  "results_count": 1
}

Error (stderr):

{
  "success": false,
  "error": {
    "code": "API_ERROR",
    "api_code": 2001,
    "message": "Insufficient credits",
    "hint": "Top up at https://pangolinfo.com/?referrer=clawhub_amz"
  }
}

🛑 Error Handling (Agent Directives)

The script outputs structured error JSON to stderr on failure. Agent should map api_code as follows:

`api_code`	Meaning	Agent action
`0`	Success	Process `results`
`1004`	Invalid token	Auto-retried by script with refreshed credentials. No action.
`1009`	Invalid parser name	Check `--parser` value matches one of the 9 supported parsers
`2001`	Insufficient credits	Show top-up link. Do NOT retry.
`2005`	No active plan	Ask user to subscribe. Do NOT retry.
`2007`	Account expired	Ask user to renew at https://tool.pangolinfo.com/. Do NOT retry.
`2009`	Usage limit reached	Wait for next billing cycle. Do NOT retry.
`2010`	Bill day not configured	Tell user to contact support. Do NOT retry.
`4029`	Rate limited	`sleep 5s`, retry once.
`10000` / `10001`	Task execution failed	Retry once with corrected URL/ASIN. Likely transient.

Critical rule: Errors 2001, 2005, 2007, 2009, 2010 mean stop immediately — retries waste credits and won't succeed.

Full error reference: references/error-codes.md.

📝 Common Recipes

# Product detail (US)
python3 scripts/pangolinfo.py --asin B0DYTF8L2W --site amz_us

# Same product on UK marketplace
python3 scripts/pangolinfo.py --asin B0DYTF8L2W --site amz_uk

# Keyword search
python3 scripts/pangolinfo.py --q "wireless mouse" --site amz_us

# Bestsellers in Electronics
python3 scripts/pangolinfo.py --content electronics --parser amzBestSellers --site amz_us

# Critical reviews (3 pages = 15 credits)
python3 scripts/pangolinfo.py --asin B0DYTF8L2W --mode review --filter-star critical --pages 3

# Variant ASINs (color/size options)
python3 scripts/pangolinfo.py --asin B0G4QPYK4Z --parser amzVariantAsin

# Auth check (free, no credits charged)
python3 scripts/pangolinfo.py --auth-only

# Raw HTML output (cheaper, 0.75 credits)
python3 scripts/pangolinfo.py --asin B0DYTF8L2W --format rawHtml

🎯 Quick Start Prompts (try with your agent)

"Get the price, rating, and BSR for ASIN B0DYTF8L2W on Amazon US."
"Fetch the top 10 bestsellers in the Electronics category and return as CSV."
"Scrape the first 50 critical reviews for B0DYTF8L2W and summarize the top 3 complaints."
"Search Amazon UK for 'wireless earbuds' and list price + rating for the top 20 results."
"Get all color/size variants of ASIN B0G4QPYK4Z."

🚫 When NOT to use

Non-Amazon sites (Walmart, Shopify, eBay) → use the corresponding Pangolinfo skill instead.
Real-time inventory / checkout — this is a read-only scraping API.
Personal account data — only public listings are accessible.

🤝 Compatible Agents

OpenClaw · Claude Code · Cursor · LangChain · LangGraph · Dify · AutoGen · Devin · Trae · Copilot

📚 References

Setup Guide — interactive first-time setup
Error Codes — full troubleshooting reference
Official API Docs
Amazon Scrape API endpoint
Pricing & credits

🌐 中文用户

亚马逊全域数据抓取 API：ASIN 详情、关键词排名、类目 BSR、评论、变体、卖家店铺。支持 13 个站点（美国、英国、加拿大、德国、法国、日本、意大利、西班牙、澳大利亚、墨西哥、沙特、阿联酋、巴西）。云端反爬，结构化 JSON 输出。

完美适配 OpenClaw、Claude Code、Cursor、LangChain 等 AI Agent 工作流。

新用户注册即送 60 免费积分，无需信用卡。

注册地址：https://tool.pangolinfo.com/?referrer=clawhub_amz