Competitor research from your terminal
The SimilarIQ CLI puts ranked competitor and look-alike data one command away — with CSV and JSON output built for piping into spreadsheets, scripts, and CI pipelines. Zero dependencies, Node 18+.
Install & first search
npm install -g similariq
similariq login sk-live-your-api-key
similariq search salesforce.com# COMPANY DOMAIN SCORE TYPE CONF LIKELY
1 HubSpot hubspot.com 97 Direct 94 Yes
2 Microsoft Dynamics microsoft.com 91 Direct 88 Yes
3 Zoho CRM zoho.com 84 Direct 86 Yes
...
100 results in 42.3s · 199 searches remainingEvery command
| Command | What it does |
|---|---|
| similariq search <domain> | Top competitors for a domain — --limit 10|25|50|100, --json, --csv (1 credit) |
| similariq bulk <file-or-list> | Bulk research a file or comma list of domains — --wait polls to completion, --out results.csv (1 credit/domain) |
| similariq job <jobId> | Bulk job status |
| similariq history | Recent searches (free) |
| similariq results <searchId> | Re-read any past search — --csv, --json (free) |
| similariq companies | My Companies export — --source domain, --csv (free) |
| similariq save <domain> | Add a company to your watchlist |
| similariq saved | List the watchlist |
| similariq share <searchId> | Create a public share link |
| similariq balance | Credits remaining |
| similariq login <api-key> | Save your key to ~/.similariq |
Built for pipelines
# Enrich a prospect list end to end
similariq bulk customers.txt --wait --out lookalikes.csv
# Feed jq / pandas / sheets
similariq search stripe.com --json | jq '.competitors[] | select(.type=="Direct")'
similariq companies --source stripe.com --csv > stripe-landscape.csv
# CI-friendly: key from the environment, clean stdout
export SIMILARIQ_API_KEY=sk-live-...
similariq search "$TARGET" --csv > artifacts/competitors.csvTables and results go to stdout; progress goes to stderr — pipes stay clean by design.
Frequently asked questions
How much does a search cost?
Every search costs 1 credit whether it returns 10 or 100 results. Credits come with any paid plan ($0.10–$0.24 per search depending on tier) or pay-as-you-go at $0.50 per search with no subscription. Reading past results, history, and exports is always free.
What data does a search return?
A ranked list of up to 100 competitors, look-alikes, and similar companies for any domain — each with a company name, website, 0-100 match score, relationship type (Direct, Indirect, Adjacent, or Emerging), a 0-100 confidence score, and a likely-competitor flag. Results are generated by SimilarIQ's proprietary AI research engine and cross-validated across multiple intelligence sources.
How do I get an API key?
Sign up free at similariq.ai, add credits or a plan, then create a key in the app under API Keys. Keys start with sk-live- and are shown once at creation. The same key works for the REST API, SDKs, CLI, and MCP server.
What happens if a search fails?
Failed searches are automatically refunded — you are only charged for searches that return results.
How does the CLI authenticate?
Three ways, in priority order: a --key flag, the SIMILARIQ_API_KEY environment variable (best for CI), or a key saved to ~/.similariq via `similariq login`. The config file is written with 0600 permissions.
Can I use the CLI in CI/CD?
Yes — set SIMILARIQ_API_KEY as a secret, and use --csv or --json for machine-readable output. Human-facing progress goes to stderr so stdout stays parseable.