Buscar empresas B2B

Request

Prospecção B2B de empresas usando dados públicos, registros oficiais e LinkedIn.

Modelo de cobrança:

Primeira requisição (sem chave de cache): 1 crédito B2B
Paginação (com chave de cache): 0 créditos
Expiração do cache: 7 dias

REGRA IMPORTANTE: Ao preencher localizacoes, deixe estados vazio, e vice-versa.

Security

ApiKeyAuth

Bodyapplication/jsonrequired

paginainteger, >= 1required

Número da página. Campo obrigatório — não possui valor padrão.

Example:1

por_paginainteger, [ 1 .. 50 ]required

Itens por página. O contrato aceita de 1 a 50. Campo obrigatório — não possui valor padrão.

Aviso operacional: apesar de o contrato aceitar até 50, valores altos podem exceder o tempo de resposta e cair como erro de transporte (conexão encerrada antes da resposta HTTP, sem status). Isso já foi observado em produção com por_pagina: 25 em /b2b/persons/. Se acontecer, reduza o valor ou pagine com chave_cache (paginação não consome créditos).

Example:20

chave_cachestring

Chave de cache (economiza créditos)

Example:"abc123xyz"

filtros_empresaobject(FiltrosEmpresa)

curl -i -X POST \
  https://docs.datastone.com.br/_mock/api/b2b/companies/ \
  -H 'Authorization: YOUR_API_KEY_HERE' \
  -H 'Content-Type: application/json' \
  -d '{
    "pagina": 1,
    "por_pagina": 20,
    "chave_cache": "abc123xyz",
    "filtros_empresa": {
      "nome_empresa": [
        "Google Brasil Internet Ltda"
      ],
      "localizacoes": [
        "São Paulo, SP",
        "Rio de Janeiro, RJ"
      ],
      "estados": [
        "SP",
        "RJ"
      ],
      "setores": [
        "Tecnologia",
        "Educação"
      ],
      "atividades_cnae": [
        "1091102 - Fabricação de produtos de padaria e confeitaria"
      ],
      "especialidades": [
        "Software"
      ],
      "tamanhos_empresa": [
        "11-50",
        "51-200"
      ],
      "naturezas_juridicas": [
        1,
        2,
        3
      ],
      "tipos_trabalho": [
        "Empresa Privada"
      ],
      "data_fundacao": {
        "data_inicio": "2010-01-01",
        "data_fim": "2023-12-31"
      },
      "faixa_receita": {
        "receita_minima": 100000,
        "receita_maxima": 5000000
      },
      "incluir_mei": true,
      "tem_cnpj": true,
      "tem_email": true,
      "tem_telefone": true,
      "tem_linkedin": true,
      "setores_cnae": [
        "Informação e Comunicação"
      ],
      "filtro_exclusao_lista": true,
      "listas_contato": [
        1,
        2
      ]
    }
  }'

Responses

Empresas encontradas com sucesso

Bodyapplication/json

sucessoboolean

Status de sucesso da requisição

Example:true

paginainteger

Página atual

Example:1

por_paginainteger

Itens por página

Example:20

chave_cachestring

Example:"abc123xyz"

totalinteger

Example:250

dadosArray of objects

Lista de empresas encontradas

Response

{
  "sucesso": true,
  "pagina": 1,
  "por_pagina": 20,
  "chave_cache": "abc123xyz",
  "total": 250,
  "dados": [
    { … }
  ]
}