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.

33 páginas de operação na API: 27 consomem créditos e 6 são gratuitas. Fonte: tabela de operações da API TAMZ, 17/11/2026.
base URL · v1
01

Comece em três passos

  1. 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. 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/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
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_id e cnae_main_desc (a atividade principal), segment (o setor TAMZ), address_city e address_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.

02

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.

Parte das empresas ativas que vem com cada campo preenchido
CampoO que éEmpresas% das ativas
cnae_main_idCNAE principal27.316.213100,0%
segmentSetor (taxonomia TAMZ)27.316.206100,0%
people_countPessoas ligadas (sócios e decisores)26.646.57297,5%
phoneTelefone do cadastro26.632.61697,5%
emailE-mail do cadastro24.735.47590,6%
websiteSite1.342.9974,9%
linkedin_urlLinkedIn da empresa523.7511,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, em resets_at e no header Retry-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.

03

Empresas

27.316.214 empresas ativas brasileiras (base de 15/11/2026) com segmentação, porte, sócios e firmográfico.

04

Pessoas

Decisores e sócios ligados às empresas — por nome, e-mail, LinkedIn ou domínio.

05

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.

06

Enriquecimento

E-mail, celular com WhatsApp e reversos. Cobra só quando entrega.

07

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.

08

Conta

Saldo, consumo e chaves do seu workspace.

Começar grátis