Contato do Lead

Name: FonteData
Author: FonteData

POST https://app.fontedata.com/api/v1/consulta/leads-contato

R$ 0,51 por consulta

Debitado do seu saldo a cada chamada cobrada. Autenticação pelo header X-API-Key. Veja como obter a chave.

Retorna os dados de contato de um registro específico. O id vem do campo id de cada item da consulta Leads por Endereço — primeiro você lista quem está no endereço, depois pede o contato apenas de quem interessa. Use o id na sequência da busca: ele identifica o registro na base de origem e não é um identificador permanente.

Cada chamada retorna um registro e é cobrada individualmente. Para obter o contato de dez registros, faça dez chamadas.

Requisição

curl -X POST -H "X-API-Key: SUA_CHAVE" \
  "https://app.fontedata.com/api/v1/consulta/leads-contato?id=48282358"

Parâmetros

Nome	Tipo	Descrição	Exemplo
id obrigatório	texto	Identificador do registro, obtido no campo `id` da consulta Leads por Endereço.	48282358

Resposta

idConsultado: eco do identificador informado.
nome: razão social completa quando é empresa; nome parcialmente mascarado quando é pessoa física.
documento: CNPJ completo quando é empresa; CPF parcialmente mascarado quando é pessoa física.
tipoPessoa: PF ou PJ.
telefones[]: ddd e numero de cada telefone. O DDD é o do telefone e pode não corresponder à região do endereço.
emails[]: e-mails associados ao registro.

Esta consulta não devolve endereço: o vínculo com o imóvel vem do filtro da consulta Leads por Endereço.

Quando o registro não tem contato na base, a resposta vem com consta: false e é cobrada normalmente — a consulta foi executada na base de origem.

Exemplo — 200 OK

{
  "nome": "CONDOMINIO EDIFICIO EXEMPLO",
  "emails": [
    "contato@exemplo.com.br"
  ],
  "documento": "00000000000191",
  "telefones": [
    {
      "ddd": "11",
      "numero": "32555361"
    },
    {
      "ddd": "11",
      "numero": "30644576"
    },
    {
      "ddd": "11",
      "numero": "31672576"
    }
  ],
  "tipoPessoa": "PJ",
  "idConsultado": "48282358"
}

Schema da resposta (JSON Schema)

JSON Schema

{
  "type": "object",
  "properties": {
    "nome": {
      "type": [
        "string",
        "null"
      ],
      "description": "Razão social completa quando o registro é empresa; nome parcialmente mascarado quando é pessoa física."
    },
    "emails": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": "string"
      },
      "description": "E-mails associados ao registro."
    },
    "documento": {
      "type": [
        "string",
        "null"
      ],
      "description": "CNPJ completo quando o registro é empresa; CPF parcialmente mascarado quando é pessoa física."
    },
    "telefones": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": "object",
        "properties": {
          "ddd": {
            "type": [
              "string",
              "integer",
              "null"
            ],
            "description": "DDD do telefone, sem o zero."
          },
          "numero": {
            "type": [
              "string",
              "integer",
              "null"
            ],
            "description": "Número do telefone, sem o DDD."
          }
        }
      },
      "x-display": "table",
      "description": "Telefones associados ao registro. O DDD é o do telefone e pode não corresponder à região do endereço — a pessoa ou empresa pode ter mantido um número de outra praça."
    },
    "tipoPessoa": {
      "type": [
        "string",
        "null"
      ],
      "description": "PF para pessoa física, PJ para empresa."
    },
    "idConsultado": {
      "type": [
        "string",
        "null"
      ],
      "description": "Eco do identificador informado na consulta."
    }
  }
}

Códigos de erro

Código	Mensagem	Quando acontece
400	Identificador inválido. Informe o `id` retornado pela consulta Leads por Endereço.	O identificador enviado não é numérico.
402	Saldo insuficiente para realizar a consulta.	A conta não tem saldo para cobrir o preço da consulta.
504	A consulta excedeu o tempo limite. Tente novamente.	A base de origem não respondeu dentro do tempo limite.
503	Serviço de consulta temporariamente indisponível. Tente novamente.	A base de origem não respondeu ou devolveu erro transitório.

Quando usar

Obter o telefone e o e-mail de um registro que você já localizou por endereço.
Falar com a administração de um condomínio: o próprio condomínio costuma aparecer como empresa, com razão social e CNPJ completos.
Montar uma lista de contatos a partir de um imóvel ou região, pagando apenas pelos registros escolhidos.

Integrar

OpenAPI (JSON) ↗ — importe a URL no Postman ou no Insomnia para gerar a coleção com todos os endpoints. Também dá para consultar pelo chat: conecte via MCP. Esta página em Markdown.