Find similar companies - Autotouch AI

This page documents the canonical HTTP contract. Switch to the CLI example when you want the operator workflow.

When to use this: choose similar companies after you already have one good seed account and want adjacent accounts.

Pricing: 1 credit per 10 returned companies. Credits are charged on actual returned results, not requested limit.

Body parameters

queryrequired
string
Semantic description of desired peer companies. Length: 10–700 characters.
company_name · optional
string
Optional seed company name, used only to exclude that seed from results.
company_domain · optional
string
Optional official seed domain, used only to exclude that seed from results.
limit · optional
integer
Maximum results. Default: 10. Range: 1–100.

Name	Type	Description
queryrequired	string	Semantic description of desired peer companies. Length: 10–700 characters.
company_name	string	Optional seed company name, used only to exclude that seed from results.
company_domain	string	Optional official seed domain, used only to exclude that seed from results.
limit	integer	Maximum results. Default: 10. Range: 1–100.

Errors

Status	Meaning
400	The search/provider rejected the request.
422	query must contain 10–700 characters; typed range or body validation failed.
401	Invalid API key or missing auth.
403	Missing search:run scope.

Example

bash

curl -X POST "https://app.autotouch.ai/api/search/similar-companies" \
  -H "Authorization: Bearer stk_your_key_id.your_secret" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "employee management software companies",
    "company_name": "Rippling",
    "limit": 20
  }'

Request body

json

{
  "query": "employee management software companies",
  "company_name": "Rippling",
  "limit": 20
}

Response example

json

{
  "query": "B2B SaaS companies selling payroll and workforce platforms to global employers",
  "items": [
    {
      "name": "Deel",
      "domain": "deel.com",
      "website": "https://deel.com",
      "description": "Global payroll and workforce platform."
    }
  ],
  "total_found": 1,
  "billable_results": 1,
  "credits_used": 1,
  "pricing_rule": "1 credit per 10 returned Exa company results",
  "metadata": {"company_name": "Rippling", "company_url": null, "item_contract": "shared_exa_company_entity_v1"}
}