Pangolinfo Amazon Scraper

Scrape Amazon programmatically — products, keywords, reviews, categories, best sellers, variants, seller storefronts — as clean structured JSON across 13 marketplaces (US/UK/CA/DE/FR/JP/IT/ES/AU/MX/SA/AE/BR). CAPTCHA & anti-bot handled in the cloud.

🎁 New users get 60 free credits (≈60 product lookups). No credit card required. 👉 Get your free API key — 30 seconds.

⚡ Quick Start (3 steps)

# 1. Register & copy your API key from https://tool.pangolinfo.com/
# 2. Set the env var
export PANGOLINFO_API_KEY="pgl_xxx"

# 3. Run your first query (use --asin shortcut, simplest)
python3 scripts/pangolinfo.py --asin B0DYTF8L2W --site amz_us

🤖 First-Time Setup (Agent Instructions)

If PANGOLINFO_API_KEY is not set, the agent MUST guide the user as follows — do NOT attempt to call the API without credentials:

"This skill needs a free Pangolinfo API key (60 free credits, no credit card).

1. Visit https://tool.pangolinfo.com/?referrer=clawhub_amz
2. Sign up with your email (30 seconds)
3. Copy the API key from the dashboard
4. Run: export PANGOLINFO_API_KEY='pgl_xxx'
5. Verify: python3 scripts/pangolinfo.py --auth-only

Then ask me to retry your request."

The API key is permanent (never expires). For interactive setup, see references/setup-guide.md.

🎯 Capabilities (9 Parsers)

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

🌍 Supported Marketplaces (13 regions)

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

💰 Credit Consumption

→ 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:

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