Empresas
Gerar ou enriquecer lista de empresas em uma chamada
O preço desta operação para a sua conta fica em Configurações → Planos, já com o valor negociado do seu workspace.
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.
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
}'Corpo da requisição
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
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
}
}
}
}Respostas e códigos
Response Body
application/json