Pangolinfo Amazon Scraper

Scrape Amazon product data via Pangolin's APIs. Returns parsed JSON with product details, search results, rankings, reviews, and more across 13 Amazon regions.

When to Use This Skill

Do not use for Google search, SERP, or non-Amazon data -- those require a different skill.

Prerequisites

• Python 3.8+ (stdlib only, no pip install needed)
• Pangolin account at pangolinfo.com
• Environment variables: PANGOLIN_API_KEY (recommended) OR PANGOLIN_EMAIL + PANGOLIN_PASSWORD

macOS SSL error? Run: /Applications/Python\ 3.x/Install\ Certificates.command

Script Execution

python3 scripts/pangolin.py --content B0DYTF8L2W --mode amazon --site amz_us

Intent-to-Command Mapping

1. Product Detail by ASIN

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

--asin auto-uppercases and selects amzProductDetail.

2. Keyword Search

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

Non-ASIN text auto-selects amzKeyword.

3. Bestsellers

python3 scripts/pangolin.py --content "electronics" --parser amzBestSellers --site amz_us

4. New Releases

python3 scripts/pangolin.py --content "toys" --parser amzNewReleases --site amz_us

5. Category Products

python3 scripts/pangolin.py --content "172282" --parser amzProductOfCategory --site amz_us

6. Seller Products

python3 scripts/pangolin.py --content "A1B2C3D4E5" --parser amzProductOfSeller --site amz_us

7. Follow Seller (Other Seller Options)

python3 scripts/pangolin.py --asin B0G4QPYK4Z --parser amzFollowSeller --site amz_us

8. Variant ASIN (Product Variants)

python3 scripts/pangolin.py --asin B0G4QPYK4Z --parser amzVariantAsin --site amz_us

9. Product Reviews

python3 scripts/pangolin.py --content B00163U4LK --mode review --site amz_us --filter-star critical

Star filter mapping:

Sort: --sort-by recent (default) or --sort-by helpful

Multiple pages: --pages N (each page costs 5 credits)

10. Product by URL (Legacy)

python3 scripts/pangolin.py --url "https://www.amazon.com/dp/B0DYTF8L2W" --mode amazon

Site code auto-inferred from URL domain.

Smart Defaults

1. ASIN detection -- 10-char codes starting with B0 auto-select amzProductDetail
2. Keyword detection -- non-ASIN text auto-selects amzKeyword
3. Defaults to amz_us if no --site provided
4. Auto-switches to review mode if --filter-star is set or --parser amzReviewV2
5. Site inferred from URL when using --url
6. Parser auto-inference only runs when --parser is not specified -- explicit --parser is never overridden

All CLI Options

Amazon Parsers

Amazon Sites

Cost

Credits consumed on success only (API code 0). Auth checks are free.

Output Format

JSON to stdout on success, error JSON to stderr on failure.

Success

{
  "success": true,
  "task_id": "02b3e90810f0450ca6d41244d6009d0f",
  "url": "https://www.amazon.com/dp/B0DYTF8L2W",
  "metadata": {
    "executionTime": 1791,
    "parserType": "amzProductDetail",
    "parsedAt": "2026-01-13T06:42:01.861Z"
  },
  "results": [ ... ],
  "results_count": 1
}

Error (stderr)

{
  "success": false,
  "error": {
    "code": "API_ERROR",
    "api_code": 2001,
    "message": "Insufficient credits",
    "hint": "Top up at pangolinfo.com."
  }
}

Response Presentation

Match the user's language. Never dump raw JSON.

• Product Detail: structured card with title, price, rating, features, rank
• Keyword Search: numbered list with title, price, rating
• Bestsellers/New Releases: ranked list emphasizing position
• Follow Seller / Variant: option comparison table
• Reviews: summary + top 3-5 reviews + pattern analysis
• Empty results: suggest checking ASIN spelling, trying another region, broadening search

Exit Codes

Error Reference

Script Error Codes

Pangolin API Error Codes

First-Time Setup

See references/setup-guide.md for interactive setup instructions.

Quick start:

export PANGOLIN_API_KEY="your-api-key"
python3 scripts/pangolin.py --auth-only

Important Notes for AI Agents

1. Never dump raw JSON. Parse and present per the Response Presentation guidelines.
2. Match the user's language.
3. Be proactive. Highlight best matches, summarize review patterns, flag out-of-stock.
4. Handle multi-step requests. E.g., "compare US vs JP price" = two queries + comparison table.
5. Credit awareness. Warn before multi-page reviews (5 credits/page).
6. ASIN detection. 10-char codes starting with B0 are almost always ASINs -- auto-detect.
7. Default to amz_us unless context implies another region.
8. Security. Never expose API keys or passwords.
9. Use --parser explicitly for category, seller, bestsellers, new releases, follow-seller, variant-asin. Auto-inference only works for ASIN vs keyword.
10. Combine results. "Find a good mouse under $30 with good reviews" = keyword search + review fetch for top candidates.

Output Schema

See references/output-schema.md for per-parser field documentation.