API KeysDocumentação

Crie uma API Key para testar os endpoints ao vivo.

Criar API Key

Esta operação consome créditos do seu workspace por chamada.

get /api/v1/company

Parâmetros

CNPJ da empresa — aceita formatado (`12.345.678/0001-90`) ou numérico puro (`12345678000190`)

Domínio do site da empresa — aceita qualquer formato (http, www, subdomínio, barra final são removidos automaticamente)

Nome da empresa — busca BM25 sobre razão social e nome fantasia. Retorna empresas ativas ordenadas por relevância.

Máximo de resultados para buscas por `domain` ou `name` (1–50, padrão 10). Ignorado para `cnpj`.

Autorização

Informe sua API key gerada em /developer/api-keys

Authorization

bearerAuth
AuthorizationBearer <token>

Informe sua API key gerada em /developer/api-keys

In: header

Query Parameters

cnpj?string

CNPJ da empresa — aceita formatado (12.345.678/0001-90) ou numérico puro (12345678000190)

domain?string

Domínio do site da empresa — aceita qualquer formato (http, www, subdomínio, barra final são removidos automaticamente)

name?string

Nome da empresa — busca BM25 sobre razão social e nome fantasia. Retorna empresas ativas ordenadas por relevância.

limit?integer

Máximo de resultados para buscas por domain ou name (1–50, padrão 10). Ignorado para cnpj.

Default10
Range1 <= value <= 50

Response Body

application/json

application/json

application/json

application/json

curl -X GET "https://tamz.ai/api/v1/company?cnpj=33000167000101&domain=totvs.com.br&name=TOTVS&limit=5"
{
  "data": [
    {
      "cnpj": "53113791000122",
      "cnpj_root": "53113791",
      "type": "MATRIZ",
      "razao_social": "TOTVS S.A.",
      "nome_fantasia": "TOTVS",
      "status": "Ativa",
      "opening_date": "1997-10-15",
      "logo_url": "string",
      "website": "totvs.com.br",
      "cnae_main_id": "6201-5",
      "cnae_main_desc": "Desenvolvimento de programas de computador sob encomenda",
      "porte_da_empresa": "Demais",
      "macro_segment": "Tecnologia & Telecom",
      "natureza_juridica_desc": "Sociedade Anônima Aberta",
      "mei_optante": false,
      "segment": "Software & SaaS",
      "sub_segment": "ERP & Gestão Empresarial",
      "size_range": "5001-10000",
      "revenue_range": "R$100M+",
      "linkedin_url": "https://linkedin.com/company/totvs",
      "address_zip": "04794-000",
      "address_street": "Avenida Braz Leme",
      "address_number": "1000",
      "address_city": "São Paulo",
      "address_state": "SP",
      "address_country": "BR"
    }
  ]
}
{
  "error": {
    "code": "MISSING_PARAM",
    "message": "Provide exactly one of: cnpj, domain, name"
  }
}
{
  "error": {
    "code": "INVALID_PARAMS",
    "message": "Invalid parameters"
  }
}
{
  "error": {
    "code": "INVALID_PARAMS",
    "message": "Invalid parameters"
  }
}