CLI

Single-binary CLI for one-off scrapes, scripting, and CI pipelines. Outputs JSON or CSV. No language runtime needed.

Get an API key View on GitHub open_in_new

Quick start

1. Install

# macOS or Linux via Homebrew
brew install chocodata-com/tap/asa

# Linux via curl
curl -sSL https://amazonscraperapi.com/cli/install.sh | bash

# Windows via Scoop
scoop bucket add chocodata https://github.com/ChocoData-com/scoop-bucket
scoop install asa

2. Authenticate

# Stores the key in ~/.asa/config.toml
asa auth login

# Or set ASA_API_KEY in your env
export ASA_API_KEY=asa_live_...

3. Scrape your first ASIN

asa product B08N5KWBKK
# {"asin":"B08N5KWBKK","title":"...","price":...,"rating":...}

# Or pretty-print
asa product B08N5KWBKK --pretty

# Or pull a different marketplace
asa product B08N5KWBKK --domain de

How-to

Search Amazon and pipe to jq

asa search "wireless earbuds" --pages 3 --format json | jq '.results[] | .asin'

Bulk-scrape ASINs from a file

# asins.txt: one ASIN per line
asa batch --file asins.txt --format csv > products.csv

# Or use stdin
cat asins.txt | asa batch --format json > products.jsonl

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: curl -sSL https://amazonscraperapi.com/cli/install.sh | bash
      - run: asa batch --file asins.txt --format csv > 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>             # single product detail
asa search <query>             # search results
asa batch [--file FILE]        # async batch (up to 1,000 ASINs)
asa usage                      # current credit balance
asa keys list                  # API keys on your account
asa auth login | logout
asa --help                     # full reference