npm - macOS / Linux / Windows - Node 18+
CLI
The asa command for one-off scrapes, shell scripts and CI pipelines. Prints JSON to stdout, errors to stderr, and pipes cleanly into jq.
Quick start
1. Install
# Global install (macOS, Linux, Windows; needs Node 18+)
npm install -g amazon-scraper-api-cli
# Or run without installing
npx amazon-scraper-api-cli product B09HN3Q81F 2. Authenticate
# Set ASA_API_KEY in your env (preferred)
export ASA_API_KEY=asa_live_...
# Or store it in a file
mkdir -p ~/.asa && echo "api_key=asa_live_..." > ~/.asa/credentials 3. Scrape your first ASIN
asa product B09HN3Q81F
# { "asin": "B09HN3Q81F", "title": "LEGEND COOKWARE ...", "price": 549.99, "rating": 4.5, ... }
# A different marketplace and language
asa product B000ALVUM6 --domain de --language de_DE How-to
Search Amazon and pipe to jq
asa search "wireless earbuds" | jq -r '.products[] | [.asin, .price, .title] | @tsv'
# Next page
asa search "wireless earbuds" --page 2 | jq -r '.products[].asin' Bulk-scrape ASINs from a file
# asins.txt: one ASIN per line -> NDJSON, one product per line
while read asin; do asa product "$asin" | jq -c .; done < asins.txt > products.ndjson
# Or queue them as one async batch (up to 1,000 items)
jq -R '{query: ., domain: "com"}' asins.txt | jq -s . > batch.json
asa batch batch.json # prints the batch id
asa batch-status <BATCH_ID> # progress, then results CI pipeline (GitHub Actions)
# .github/workflows/scrape.yml
name: Daily price scrape
on:
schedule:
- cron: "0 6 * * *"
jobs:
scrape:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- run: npm install -g amazon-scraper-api-cli
- run: |
while read asin; do
asa product "$asin" | jq -r '[.asin, .price, .currency] | @csv'
done < asins.txt > prices-$(date +%F).csv
env:
ASA_API_KEY: ${{ secrets.ASA_API_KEY }}
- uses: actions/upload-artifact@v4
with:
path: prices-*.csv Available commands
asa product <ASIN> [--domain com] [--language en_US]
asa search <QUERY> [--domain com] [--sort best_match|price_asc|price_desc|avg_customer_review|newest] [--page N]
asa batch <FILE.json> [--endpoint amazon.product|amazon.search] [--webhook URL]
asa batch-status <BATCH_ID>
asa --help | --version Why use the CLI?
One npm install
`npm install -g amazon-scraper-api-cli` on any machine with Node 18+, or `npx` it with no install at all.
Pipe-friendly
JSON on stdout works with jq, fx, mlr and any Unix pipe. Turn it into CSV or TSV with a one-line jq filter.
Built for cron and CI
Reads `ASA_API_KEY` from env. Errors go to stderr with exit code 1, so CI runners fail the step; failed requests are never billed.
Async batch
`asa batch` queues up to 1,000 products or searches from a JSON file, with an optional webhook; `asa batch-status` returns progress and results.
Official resources
- GitHub repo - source + releases + issues
- npm package - install, README with every command and flag
- API documentation - the endpoints the CLI wraps
Pricing
Same rate across every integration. Monthly plans from $19 or pay-as-you-go at $0.90 per 1,000 successful requests. 1,000 free on signup.
Free
Forever free on signup
- check_circle1,000 requests / month
- check_circle50 concurrent requests
- check_circleAll 20 marketplaces
- check_circleFull dashboard + analytics
- check_circleTop-up at $0.90 / 1k
- check_circleCommunity support
Vibe
$0.70 / 1k effective
- check_circle27,000 requests / month
- check_circle100 concurrent requests
- check_circleAll endpoints + content-language
- check_circleCountry-matched residential IPs
- check_circlePer-API-key usage tracking
- check_circleTop-up at $0.90 / 1k
- check_circleEmail support (1 business day)
Pro
$0.60 / 1k effective
- check_circle82,000 requests / month
- check_circle200 concurrent requests
- check_circlePriority routing queue
- check_circleCountry-matched residential IPs
- check_circleTeam seats (up to 5)
- check_circleTop-up at $0.90 / 1k
- check_circleEmail + chat support
Custom
Flat $0.50 / 1k effective at every level
- check_circle200k - 4M+ requests / month
- check_circle300-1000+ concurrent requests
- check_circlePriority queue (highest)
- check_circlePremium proxy pool + SLA on request
- check_circleUnlimited team seats
- check_circleWire / invoice / annual PO
- check_circleDedicated Slack channel
Pay-as-you-go top-up
$0.90 / 1,000 successful requests
Available on every plan including Free. Top up any time when included credits run out. Only 2xx responses charged. Balance never expires.
Install the CLI
1,000 free requests on signup. No credit card required.