Documentação da API
A base B2B do Brasil, por REST.
Empresas, decisores e enriquecimento de contato numa API só. Autenticação por Bearer token, JSON em tudo, e cobrança por registro devolvido — resposta vazia não debita.
O que vem em cada empresa e como a base se compara aos dados públicos de CNPJ: base de dados de empresas brasileiras. Sem código, pelo Explorar: lista de leads B2B com e-mail e telefone. Visão geral, exemplos e como conectar o MCP: API de dados de empresas e MCP. Passo a passo do MCP no Claude, no Cursor e no ChatGPT, com prompts prontos: prospecção B2B no Claude e no ChatGPT via MCP. Os sinais que a API entrega, explicados: sinais de compra B2B · novas empresas abertas.
Comece em três passos
- 1/3
Crie sua chave
Gratuita, no painel. Vai no header Authorization como Bearer. A mesma chave liga o MCP a agentes de IA em vendas B2B.
Gerar API key - 2/3
Faça a primeira chamada
Um lookup de empresa por domínio já devolve o cadastro completo. Para conferir um CNPJ sem código, use a consulta de CNPJ grátis e sem cadastro.
Ver o endpoint - 3/3
Entenda os créditos
Cobrança em créditos da franquia: no Starter, 1 crédito sai a R$ 0,0355 (mais barato nos planos maiores). O preço de cada operação para a sua conta fica em Configurações. A tabela pública está em planos e preços do TAMZ.
Ver meus preços
curl "https://tamz.ai/api/v1/company?domain=exemplo.com.br" \
-H "Authorization: Bearer tamz_SUA_API_KEY"O que a API faz, em uma chamada
A API da TAMZ devolve os dados de uma empresa brasileira a partir do domínio dela ou do CNPJ. A resposta traz o cadastro: razão social, atividade, porte, endereço e sócios. Você autentica com uma chave, chama um endereço e recebe JSON.
O cURL acima, do passo 2, faz uma consulta de empresa por domínio. Na resposta:
data: a lista com a empresa encontrada (vazia, se nenhuma). Os campos de cadastro são, entre outros,cnpj,legal_name(razão social),trade_name(nome fantasia),cnae_main_idecnae_main_desc(a atividade principal),segment(o setor TAMZ),address_cityeaddress_state.meta.credits_used: quantos créditos a chamada consumiu. Toda resposta paga traz esse campo. Se a busca não achar nada, ela não debita.
Uma consulta pontual, como esta, devolve a empresa completa. Nas listagens, você escolhe o nível de detalhe com o parâmetro fields: o nível básico traz o essencial de cada empresa, e o nível rico acrescenta o firmográfico, como site, LinkedIn, porte e faixa de faturamento, com uma sobretaxa por linha.
O que vem preenchido em cada empresa
Nem toda empresa tem todos os campos. Para quem integra, o que importa é saber quantas empresas vão voltar com cada um. A tabela abaixo mostra, em porcentagem das 27.316.214 empresas ativas, quantas têm cada campo na base de 15/11/2026.
| Campo | O que é | Empresas | % das ativas |
|---|---|---|---|
| cnae_main_id | CNAE principal | 27.316.213 | 100,0% |
| segment | Setor (taxonomia TAMZ) | 27.316.206 | 100,0% |
| people_count | Pessoas ligadas (sócios e decisores) | 26.646.572 | 97,5% |
| phone | Telefone do cadastro | 26.632.616 | 97,5% |
| E-mail do cadastro | 24.735.475 | 90,6% | |
| website | Site | 1.342.997 | 4,9% |
| linkedin_url | LinkedIn da empresa | 523.751 | 1,9% |
Fonte: TAMZ, base de CNPJ de 15/11/2026; 27.316.214 empresas ativas (matrizes). E-mail e celular de decisor são enriquecimento, cobrado por entrega, e não entram nesta conta.
Há três tipos de campo, e é bom não misturar. O primeiro é o cadastro: razão social, atividade, endereço, porte e sócios. Quase toda empresa tem. O segundo é a estimativa da TAMZ: setor, faixa de funcionários e faixa de faturamento. Estimativa não é dado declarado pela empresa, e a resposta deve ser lida assim. O terceiro é o enriquecimento: o e-mail e o telefone de uma pessoa, que não saem de busca nem de listagem. Eles vêm dos endpoints de enriquecimento, são cobrados por entrega e têm outra taxa de cobertura, que esta tabela não mede.
O telefone e o e-mail do cadastro da empresa são os que ela informou à Receita Federal. Podem ser os de um terceiro, como o escritório de contabilidade, e podem estar desatualizados.
Autenticação, limites e erros
Autenticação. Envie a chave no header Authorization: Bearer tamz_.... O header X-API-Key: tamz_... também funciona. Chave ausente ou inválida devolve o erro 401.
Limites de taxa. A busca aceita 100 requisições por minuto e o enriquecimento, 50. O disparo do Growth tem um limite menor, que está no OpenAPI. Ao passar do limite, a API devolve o erro 429. O corpo do erro traz retry_after, os segundos até a janela resetar, e os headers X-RateLimit-Remaining e X-RateLimit-Reset acompanham a resposta. Faça uma espera crescente a partir de retry_after, com teto de 60 segundos, em vez de repetir na hora.
Formato do erro. Todo erro tem a mesma forma: um objeto error com code, o identificador do erro, e message, a mensagem. Os códigos mais comuns são:
- 400,
INVALID_PARAMS: parâmetro inválido. - 401,
UNAUTHORIZED: chave ausente ou inválida. - 402,
INSUFFICIENT_CREDITS: créditos insuficientes. A resposta traz o saldo disponível, o que a operação exige e o caminho para ampliar o plano. - 404,
NOT_FOUND: recurso não encontrado, por exemplo uma empresa que não está na base. - 429,
RATE_LIMITED: limite de taxa excedido. - 429,
CONTACT_QUOTA_EXCEEDED: cota diária de contatos revelados do plano Grátis atingida. Nada é cobrado; a resposta diz quando a cota renova (meia-noite de Brasília, emresets_ate no headerRetry-After) e traz o caminho para o plano pago. - 503: serviço indisponível no momento. Tente de novo em instantes.
Paginação e volume. A listagem de empresas usa os parâmetros page e limit. Há um teto diário de linhas por workspace, igual para todos, como proteção contra cópia em massa. Ao atingir o teto, a resposta explica como estreitar o filtro e informa quando a cota volta. Para públicos maiores que o teto, monte uma lista pelo fluxo de listas do MCP, em vez de paginar.
Hoje, o teto diário é de 30.000 linhas por workspace, e o dia é contado em UTC.
Créditos: quando debita
A cobrança é por registro devolvido, e não por chamada. Em uma listagem, cada empresa devolvida custa um crédito no nível básico. Resposta vazia não debita: uma busca com zero resultados não custa nada.
O enriquecimento cobra por dado entregue. Se a TAMZ não encontra o e-mail ou o telefone, não há cobrança. O preço de cada operação para a sua conta, já com qualquer valor combinado, está em Configurações, na página de planos. O OpenAPI não traz valores de propósito: um preço de tabela confundiria quem tem acordo próprio. Toda resposta paga devolve meta.credits_used, e você consulta o saldo pelo endpoint de créditos.
MCP: a mesma API no agente de IA
O MCP é a mesma base, aberta para agentes de IA. Em vez de escrever código, você conecta o agente uma vez, e ele decide quando consultar a base enquanto conversa. A chave e os créditos são os mesmos da API: o que muda é quem faz a chamada.
Use a API quando um sistema, como o CRM ou um fluxo de automação, precisa chamar a base por código. Use o MCP quando uma pessoa pede ao agente algo como "quais empresas de transporte abriram em Minas neste mês?". O passo a passo no Claude, no Cursor e no ChatGPT está no post prospecção B2B no Claude e no ChatGPT via MCP, e a visão geral do produto está em API de dados de empresas e MCP.
Empresas
27.316.214 empresas ativas brasileiras (base de 15/11/2026) com segmentação, porte, sócios e firmográfico.
- Consulta de empresaGET
/api/v1/companyconsome créditos - Detalhe por CNPJGET
/api/v1/companies/{cnpj}consome créditos - Sócios da empresaGET
/api/v1/companies/{cnpj}/ownersconsome créditos - Resolver por domínioGET
/api/v1/companies/domain/{domain}consome créditos - Buscar empresasGET
/api/v1/companiesconsome créditos - Gerar ou enriquecer listaPOST
/api/v1/companies/queryconsome créditos - Autocomplete por nomeGET
/api/v1/companies/autocompleteconsome créditos
Pessoas
Decisores e sócios ligados às empresas — por nome, e-mail, LinkedIn ou domínio.
- Pessoa por email/telefone/LinkedInGET
/api/v1/personconsome créditos - Pessoa por nome + domínioPOST
/api/v1/find-person-by-domainconsome créditos - Pessoas de empresas (ao vivo)POST
/api/v1/people/discoverconsome créditos - Gerar ou enriquecer pessoasPOST
/api/v1/people/queryconsome créditos - Buscar pessoasGET
/api/v1/peopleconsome créditos - Pessoas da empresaGET
/api/v1/companies/{cnpj}/peopleconsome créditos - Buscar sóciosGET
/api/v1/ownersconsome créditos - Empresas onde é sóciaGET
/api/v1/search/by-ownerconsome créditos
Sinais
O que aconteceu com a empresa e quando — filial nova, sócio que saiu, vaga aberta, notícia. É o que responde por que ligar hoje.
Enriquecimento
E-mail, celular com WhatsApp e reversos. Cobra só quando entrega.
- Enriquecer empresaPOST
/api/v1/enrichment/companyconsome créditos - Enriquecer pessoaPOST
/api/v1/enrichment/personconsome créditos - Validar WhatsAppPOST
/api/v1/enrichment/whatsappconsome créditos - E-mail profissionalPOST
/api/v1/enrichment/email-workconsome créditos - Reverse PF (CPF/email)POST
/api/v1/enrichment/person-reverseconsome créditos - Reverso por e-mailPOST
/api/v1/enrichment/reverse-emailconsome créditos - Reverso por celularPOST
/api/v1/enrichment/reverse-phoneconsome créditos - Revelar em lotePOST
/api/v1/enrichment/batchconsome créditos - Enriquecer em massaPOST
/api/v1/enrichment/bulkconsome créditos - Status do lote em massaGET
/api/v1/enrichment/bulk/{id}gratuito
Growth
Seu diagnóstico contra os concorrentes, palavras-chave, site e presença nas IAs — leitura grátis; disparar uma execução consome créditos.
Conta
Saldo, consumo e chaves do seu workspace.