Empresas

Buscar empresas

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

Busca empresas brasileiras com filtros. Retorna até 25 resultados por página (limit, padrão 10). Cobra por registro devolvido; zero resultados não debitam. Por padrão devolve o nível lean — passe fields=rich para o pacote firmográfico (website, LinkedIn, porte, faturamento, funcionários, sócios) com sobretaxa por linha.

01

Testar ao vivo

Parâmetros

Busca por texto (razão social, nome fantasia, descrição)

Filtrar por domínio do site

Filtrar por estado (UF). Pode repetir para múltiplos.

Porte conforme enquadramento legal. Valores: Micro, Pequeno porte, Demais

Segmento de atuação, derivado do CNAE principal. Valores exatos e sem acentuação (TI & Servicos Digitais, não TI & Serviços Digitais). Repita o parâmetro para somar segmentos.

CNAE: código de 7 dígitos (ex: 6201500), prefixo numérico (62) ou nome de atividade (restaurante). Pode repetir. Nome não reconhecido responde 400 INVALID_FILTER_VALUE com sugestões.

Faixa de faturamento estimada. Valores exatos, em caixa alta (repita o parâmetro para somar faixas: ?revenue=ENTRE 2MM E 5MM&revenue=ENTRE 5MM E 10MM). Cobertura parcial: é campo estimado, ausente em parte da base — empresa sem estimativa não entra no resultado.

Faixa de funcionários (vínculos formais). Valores exatos; repita o parâmetro para somar faixas. Cobertura parcial: é campo estimado. Para o porte cadastral oficial, use porte.

Sinais de momento da empresa, em JSON (codifique na URL): array de até 6 filtros { events, window_days, present }. - events: any (qualquer sinal), contratacao (contratação), filial (abertura de filial), aporte (notícia de aporte), porte (aumento de porte), socio (entrada de sócio). Eventos combinam com E; use any para qualquer sinal. - window_days: 30, 90, 180 ou 360 (padrão 180). - present: true (padrão) = tem o sinal na janela; false = não tem. Vários filtros também combinam com E. Evento ou janela inválidos → 400 INVALID_PARAMS com os valores válidos. O filtro aplicado volta em meta.signals_applied.

true = tira as empresas que o workspace já recebeu (membro ativo da Carteira com algum dado já entregue; empresa só registrada por uma busca de pessoas não conta). Padrão false; aceita só true ou false. exclude_enriched_channels vale só para pessoas — aqui é 400.

Tira quem já está nestas listas do workspace (UUIDs). Repita o parâmetro ou separe por vírgula; máximo 20. Lista de outro workspace é ignorada.

Página (default: 1)

Registros por página: 1 a 25 (padrão 10). Cada registro devolvido é cobrado no nível lean.

Nível de campos da resposta. lean (padrão) devolve só o cadastro que identifica o registro, cobrado por linha. rich acrescenta os campos firmográficos/LinkedIn e cobra uma sobretaxa por linha no mesmo débito.

Autorização

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

Sua requisição

curl -X GET 'https://tamz.ai/api/v1/companies' \
  -H 'Authorization: Bearer tamz_SUA_API_KEY'
02

Exemplo de retorno

{
  "data": [
    {
      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
      "cnpj": "33000167000101",
      "cnpj_root": "33000167",
      "type": "matriz",
      "legal_name": "Petroleo Brasileiro S A Petrobras",
      "trade_name": "Petrobras - Edise",
      "status": "Ativa",
      "opening_date": "1953-10-03",
      "cnae_main_id": "0600001",
      "cnae_main_desc": "Extração de petróleo e gás natural",
      "macro_segment": "Industria & Manufatura",
      "segment": "Outras Industrias",
      "sub_segment": "Industria Diversa",
      "natureza_juridica_desc": "Sociedade Anônima Aberta",
      "porte_da_empresa": "Demais",
      "mei_optante": false,
      "capital_social": 205431960490.29,
      "people_count": 50874,
      "revenue_range": "ACIMA DE 1BI",
      "size_range": "500-999",
      "veiculos_faixa": "500+",
      "website": "petrobras.com.br",
      "logo_url": "https://logo.tamz.ai/petrobras.com.br",
      "linkedin_url": "https://linkedin.com/company/petrobras",
      "linkedin_followers": 2145000,
      "address_zip": "20031-912",
      "address_street": "Avenida Republica do Chile",
      "address_number": "65",
      "address_city": "Rio de Janeiro",
      "address_state": "RJ",
      "address_country": "BR",
      "owners": [
        {
          "person_id": "087e858e-473c-4f50-b5b0-c1df6c021550",
          "name": "Angelica Laureano",
          "cpf": "34791213734",
          "idade": 71,
          "sexo": "F",
          "role": "Diretor",
          "equity_pct": 25.5
        }
      ],
      "owners_truncated": false
    }
  ],
  "meta": {
    "page": 1,
    "limit": 10,
    "offset": 0,
    "total": 187069,
    "has_more": true,
    "signals_applied": [
      {
        "events": [
          "filial"
        ],
        "window_days": 360,
        "present": true
      }
    ]
  }
}
{
  "error": {
    "code": "INVALID_PARAMS",
    "message": "Invalid parameters"
  }
}
{
  "error": {
    "code": "UNAUTHORIZED",
    "message": "Missing API key. Use Authorization: Bearer tamz_xxx or X-API-Key header"
  }
}
{
  "error": {
    "code": "RATE_LIMITED",
    "message": "Rate limit exceeded",
    "retry_after": 42
  }
}
03

Respostas e códigos

Response Body

application/json

application/json

application/json

application/json

Começar grátis