Empresas

Gerar ou enriquecer lista de empresas em uma chamada

POST 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.

Cobrança: consome créditos, por empresa entregue (base) e mais 2 itens de preço. Fonte: tabela de operações da API TAMZ, 08/11/2026.

Uma chamada para gerar uma lista (filters) OU enriquecer uma lista existente (identifiers: cnpj, domain ou linkedin_url, até 100), com os módulos de include[] do catálogo (GET /api/v1/catalog).

Preço por item: base (1 por empresa entregue) + a soma das inclusões entregues, pelo preço do seu workspace. Inclusão sem dado, identificador não resolvido e dado já pago nos últimos 30 dias não cobram. A mesma empresa pedida duas vezes conta uma vez; módulo de escopo raiz cobra uma vez por raiz.

Teto: max_credits nunca é ultrapassado — a chamada corta itens antes de buscar e devolve meta.truncated: true com meta.cursor para continuar (reenvie o mesmo corpo com o cursor).

dry_run: devolve estimate {min,max} e matches_bucket (0, 1–9, 10–99, 100–999, 1.000+), sem débito e sem rodar inclusões. A contagem exata é paga: count: true.

⚡ Consome créditos do workspace.

Rate limit: 50 req/min.

01

Testar ao vivo

Autorização

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

Sua requisição

curl -X POST 'https://tamz.ai/api/v1/companies/query' \
  -H 'Authorization: Bearer tamz_SUA_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
  "dry_run": false,
  "count": false
}'
02

Corpo da requisição

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

03

Exemplo de retorno

{
  "data": [
    {
      "status": "ok",
      "cnpj": "11222333000181",
      "base": {
        "cnpj": "11222333000181",
        "razao_social": "Transportes Exemplo Ltda",
        "cnae": "4930202",
        "cidade": "Campinas",
        "uf": "SP",
        "situacao": "ATIVA"
      },
      "base_status": "delivered",
      "includes": {
        "firmografico": {
          "status": "delivered",
          "scope": "raiz",
          "data": {
            "porte": "Demais",
            "faturamento_faixa": "10 mi a 25 mi (estimado)",
            "funcionarios_faixa": "50 a 99",
            "filiais": 3,
            "linkedin": null,
            "website_verificado": "https://transportesexemplo.example",
            "capital_social": 500000,
            "data_abertura": "2009-05-12"
          }
        },
        "contato_empresa": {
          "status": "no_data",
          "scope": "estabelecimento",
          "data": null
        }
      }
    }
  ],
  "meta": {
    "mode": "filters",
    "returned": 1,
    "truncated": false,
    "cursor": null,
    "credits": {
      "reserved": 70,
      "charged": 4,
      "released": 66
    },
    "by_module": {
      "firmografico": {
        "items": 1,
        "credits": 3
      }
    }
  }
}
Empty
Empty
Empty
Empty
Empty
Empty
04

Respostas e códigos

Response Body

application/json

Começar grátis