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/chocodata

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

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

2. Authenticate

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

# Or set CHOCODATA_API_KEY in your env
export CHOCODATA_API_KEY=cd_live_...

3. Scrape your first product

chocodata product B08N5KWBKK
# {"id":"B08N5KWBKK","title":"...","price":...,"rating":...}

# Or pretty-print
chocodata product B08N5KWBKK --pretty

# Or pull a different region
chocodata product B08N5KWBKK --domain de

How-to

Run a search and pipe to jq

chocodata search "wireless earbuds" --site google --pages 3 --format json | jq '.results[] | .url'

Bulk-scrape IDs from a file

# ids.txt: one product ID or URL per line
chocodata batch --file ids.txt --format csv > products.csv

# Or use stdin
cat ids.txt | chocodata 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://chocodata.com/cli/install.sh | bash
      - run: chocodata batch --file ids.txt --format csv > prices-$(date +%F).csv
        env:
          CHOCODATA_API_KEY: ${{ secrets.CHOCODATA_API_KEY }}
      - uses: actions/upload-artifact@v4
        with:
          path: prices-*.csv

Available commands

chocodata product <ID>               # single product detail
chocodata search <query>             # search results
chocodata batch [--file FILE]        # async batch (up to 1,000 items)
chocodata usage                      # current credit balance
chocodata keys list                  # API keys on your account
chocodata auth login | logout
chocodata --help                     # full reference