The Competitor Research API
One POST request in — the top 100 competitors, look-alikes, and similar companies out. Scored, ranked, and cross-validated by SimilarIQ's proprietary AI research engine. Perfect for enriching CRMs, powering market maps, building prospecting tools, and automating competitive intel.
30-second quick start
curl -X POST https://similariq.ai/api/v1/search \
-H "X-API-Key: sk-live-your-api-key" \
-H "Content-Type: application/json" \
-d '{"domain": "salesforce.com", "limit": 100}'Response
{
"domain": "salesforce.com",
"totalCompetitors": 100,
"likelyCompetitors": 87,
"elapsedSeconds": 42.3,
"creditsRemaining": 199,
"competitors": [
{ "rank": 1, "company": "HubSpot", "domain": "hubspot.com",
"matchScore": 97, "type": "Direct", "confidence": 94,
"likelyCompetitor": true }
]
}Every endpoint
| Endpoint | What it does |
|---|---|
| POST /api/v1/search | Full competitor search for a domain (1 credit, 30–60s, synchronous JSON) |
| GET /api/v1/balance | Remaining search credits (free) |
| POST /api/bulk/upload | Bulk research a CSV of domains — 1 credit per domain, returns a jobId |
| GET /api/bulk/jobs/:id | Bulk job status with per-domain results (free) |
| GET /api/bulk/jobs/:id/download | Bulk results as CSV (free) |
| GET /api/history | Your recent searches (free) |
| GET /api/searches/:id | Full results of any past search — re-reading never re-charges (free) |
| GET /api/my-companies | Every company found across all your searches, up to 5,000 rows (free) |
| POST /api/searches/:id/share | Create a public read-only share link (free) |
| GET / POST /api/saved-companies | Your watchlist (free) |
| POST / GET / DELETE /api/auth/api-keys | Create, list, and revoke API keys |
What people build with it
Attach a live competitor list to every account record in Salesforce or HubSpot.
Feed in your best customers, get back the 100 most similar companies to target next.
Automate competitive landscape decks that update themselves.
Instantly map the competitive set around any target company.
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.
Is there a rate limit?
Requests share a standard per-IP and per-key limiter that smooths bursts. Searches take 30-60 seconds each; for high-volume enrichment use the bulk endpoints or contact support@similariq.ai for dedicated limits.
Do you offer a free trial of the API?
Yes — every new account gets free searches to try the product, and pay-as-you-go credits start at a $10 minimum with no subscription required.