Empresas

Autocomplete de empresas por nome

GET consome créditos

O preço desta operação para a sua conta fica em Configurações → Planos, já com o valor negociado do seu workspace.

Sugestões de empresas por nome (BM25 + dedup + ranking por nº de pessoas/porte). Retorna até 10 candidatos com nome, website e logo — ideal para campos de busca com typeahead server-side.

⚡ Consome créditos por busca válida que executa o RPC. Query com menos de 3 caracteres (400) e entrada que parece CNPJ (resultado vazio) NÃO cobram.

Rate limit: 60 req/min

01

Testar ao vivo

Parâmetros

Texto de busca (mín. 3 caracteres). Entrada com cara de CNPJ retorna lista vazia (use /api/v1/company para CNPJ).

Autorização

Sua API key, gerada em /developer/api-keys. Gratuita para começar.

Sua requisição

curl -X GET 'https://tamz.ai/api/v1/companies/autocomplete?q=totvs' \
  -H 'Authorization: Bearer tamz_SUA_API_KEY'
02

Exemplo de retorno

{
  "results": [
    {
      "name": "TOTVS",
      "website": "totvs.com.br",
      "logoUrl": null
    }
  ]
}
{
  "error": {
    "code": "QUERY_TOO_SHORT",
    "message": "Query must have at least 3 characters"
  }
}
{
  "error": {
    "code": "UNAUTHORIZED",
    "message": "Missing API key. Use Authorization: Bearer tamz_xxx or X-API-Key header"
  }
}
{
  "error": {
    "code": "INSUFFICIENT_CREDITS",
    "message": "Insufficient credits",
    "required": 10,
    "available": 3,
    "upgrade_path": "/settings/plans",
    "next_action": "Top up credits and retry — zero-result searches are never charged."
  }
}
{
  "error": {
    "code": "RATE_LIMITED",
    "message": "Rate limit exceeded",
    "retry_after": 42
  }
}
03

Respostas e códigos

Response Body

application/json

application/json

application/json

application/json

application/json

Começar grátis