Empresas

Consulta de empresa (básico, firmográfico ou intelligence)

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.

A consulta de empresa da API. Identifique UMA empresa por cnpj, domain ou linkedin_url e escolha o nível com level:

levelcréditosconteúdo
basico2CNPJ, razão social, nome fantasia, situação, endereço completo, CNAE, segmento, porte, natureza jurídica, abertura, telefone e e-mail da empresa
firmografico (padrão)4básico + nº de filiais, faturamento estimado (faixa), nº de funcionários, site comprovado, LinkedIn/seguidores, sócios, porte, faixa de frota
intelligence24 (4 + 20)firmográfico + sinais econômicos dos últimos 365 dias

Preços de catálogo; o price book do workspace pode ter valores próprios por chave. A mesma empresa consultada nos últimos 30 dias não é cobrada de novo (por nível; os sinais seguem a mesma janela da /companies/{cnpj}/signals). Sem match confiável → data: [] e nada é debitado. No intelligence, se não houver sinal cobrável a parte de sinais não é debitada.

  • cnpj: aceita 12.345.678/0001-90 ou 12345678000190
  • domain: aceita qualquer formato (https://www.exemplo.com.br/ → exemplo.com.br), resolvido pelo mapa verificado domínio→CNPJ (0% falso-positivo)
  • linkedin_url: página de empresa (https://www.linkedin.com/company/<slug>); só devolve a empresa quando a correspondência é inequívoca
  • name: busca por razão social/nome fantasia (lista; level não se aplica). Combina com domain como filtro.

cnpj e linkedin_url não combinam com outros identificadores.

Rate limit: 60 req/min

⚡ Consome créditos por empresa entregue — resposta vazia não debita.

01

Testar ao vivo

Parâmetros

CNPJ da empresa — aceita formatado (12.345.678/0001-90) ou numérico puro (12345678000190)

Domínio do site da empresa — aceita qualquer formato (http, www, subdomínio, barra final são removidos automaticamente)

URL da página de empresa no LinkedIn (linkedin.com/company/<slug>; aceita br.linkedin.com, /about e query string).

Nome da empresa — busca BM25 sobre razão social e nome fantasia. Retorna empresas ativas ordenadas por relevância.

Nível da consulta para cnpj/domain/linkedin_url. Padrão firmografico (o contrato de sempre).

Máximo de resultados da busca por name (1–50, padrão 10). Ignorado nos lookups.

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/company' \
  -H 'Authorization: Bearer tamz_SUA_API_KEY'
02

Exemplo de retorno

{
  "data": [
    {
      "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,
      "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,
      "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,
      "address_zip": "20031-912",
      "address_street": "Avenida Republica do Chile",
      "address_number": "65",
      "address_city": "Rio de Janeiro",
      "address_state": "RJ",
      "address_country": "BR",
      "address_neighborhood": "string",
      "phone": "1133334444",
      "phone_ddd": "string",
      "email": "string",
      "branches_count": 0,
      "employees_count": 0,
      "website_verified": true,
      "razao_social": "string",
      "nome_fantasia": "string"
    }
  ],
  "meta": {
    "level": "basico",
    "requested_level": "intelligence",
    "match": "unmatched"
  }
}
{
  "error": {
    "code": "MISSING_PARAM",
    "message": "Provide exactly one of: cnpj, domain, name"
  }
}
{
  "error": {
    "code": "INVALID_PARAMS",
    "message": "Invalid parameters"
  }
}
Empty
{
  "error": {
    "code": "INVALID_PARAMS",
    "message": "Invalid parameters"
  }
}
Empty
03

Respostas e códigos

Response Body

application/json

application/json

application/json

application/json

Começar grátis