Search 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 company search when you are still discovering which accounts fit the market, product, or industry description.

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

Provider model: this is a provider-hidden search family. The response is normalized and does not expose the underlying search engine.

See Choosing a list-building path for company-first vs people-first guidance.

Body parameters

queryrequired
string
Natural-language company search query.
limit · optional
integer
Maximum companies to return. Default: 10. Max: 100.

Name	Type	Description
queryrequired	string	Natural-language company search query.
limit	integer	Maximum companies to return. Default: 10. Max: 100.

Errors

Status	Meaning
400	The search/provider rejected the request.
401	Invalid API key or missing auth.
403	Missing search:run scope.
422	The JSON request does not satisfy the typed request model.

Example

bash

curl -X POST "https://app.autotouch.ai/api/search/companies" \
  -H "Authorization: Bearer stk_your_key_id.your_secret" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "remote IT asset management companies",
    "limit": 25
  }'

Request body

json

{
  "query": "remote IT asset management companies",
  "limit": 25
}

Response example

json

{
  "query": "remote IT asset management companies",
  "items": [
    {
      "name": "Acme Devices",
      "domain": "acmedevices.com",
      "website": "https://acmedevices.com",
      "description": "Device lifecycle platform for distributed teams.",
      "location": "Austin, Texas, United States"
    }
  ],
  "total_found": 1,
  "billable_results": 1,
  "credits_used": 1,
  "pricing_rule": "1 credit per 10 returned Exa company results",
  "metadata": {}
}