↑↓ navigate open esc close
npm · @data-atlas/cli

Government contracts from your terminal.

The selltostate binary is a thin wrapper over the REST API — every command maps 1:1 to an endpoint. Pipe structured tender data into build scripts, CI, or your CRM import, with --format table|json|csv.

# Install & go

npm i -g @data-atlas/cli

# verify + persist your key
selltostate auth login

selltostate search "cybersecurity" \
  --scope tenders --year-min 2023

selltostate get buyer \
  ministry-of-education

Or one-off: STS_API_KEY=sts_… selltostate whoami.

Auth & config.

The CLI authenticates with a dashboard API key sent as x-api-key — the same machine credential the REST routes and MCP server accept. selltostate auth login verifies the key via /whoami and persists it at ~/.config/selltostate/config.json (mode 0600).

Resolution order: --api-key/--api-url flags → STS_API_KEY/STS_API_URL env → the config file → default host. A 402 prints the payment_link; a 401 points you at auth login. Exit codes: 0 ok · 2 unauthorized · 3 payment required · 4 rate limited · 64 usage.

Commands.

Each maps 1:1 to a REST endpoint. Full flags in the reference (x-cli extension).

selltostate auth login Verify a key via /whoami and store it (~/.config/selltostate/config.json, 0600).
selltostate whoami Auth + entitlement + scopes + export cap.
selltostate search <q> --scope tenders Faceted search (--sector --country --year-min/max --amount-min/max …).
selltostate awards --supplier ACME Awarded-tender rows (402-gated).
selltostate get buyer <slug> Entity detail: buyer | supplier | tender | sector.
selltostate buyers / suppliers / sectors Top-N agencies, suppliers, and the sector taxonomy.
selltostate lists ls|create|add|rm|… Saved award lists (requires a user API key).
selltostate saved-searches ls|save|… Saved searches (requires a user API key).
selltostate export --supplier ACME -o awards.csv Stream the entitlement-capped CSV.
selltostate price / pay Live price (no auth) · activate a subscription autonomously.

Script it.

# JSON out → jq → pipeline
selltostate search "cloud infrastructure" --scope tenders --json \
  | jq '.hits[] | {id, agency: .buyer_name, amount: .awarded_amt}'

# CSV export straight to disk
selltostate export --agency ministry-of-education --year 2024 -o moe-2024.csv

# Build a saved list from a search (user key)
selltostate lists create "Cyber FY24"
selltostate lists add lst_abc --tender MOE000ETT24300001

Install the CLI.

Start a free trial, create an API key under Account → API keys, then npm i -g @data-atlas/cli and selltostate auth login. Full command docs at docs.selltostate.com.

Start for free →
Sign Up