Integre seu leilão à Spy Leilões em minutos
Disponibilize um endpoint JSON com os dados dos leilões e nossa plataforma cuida do resto: indexação, busca, mapa, alertas no WhatsApp e exposição para mais de 60 mil investidores cadastrados.
19 campos obrigatórios + 2 quando aplicável
Todos os campos obrigatórios são necessários para que seu leilão seja indexado e exibido com qualidade. Os campos condicionais (em âmbar) só precisam ser enviados quando existirem no leilão — como a terceira praça.
Nomes dos campos são flexíveis
Os nomes acima (titulo, data_primeira_praca, endereco...) são apenas referência. Seu endpoint pode usar qualquer convenção de nomenclatura (camelCase, PascalCase, em inglês, etc.) — desde que entregue todos os dados solicitados. Antes de ativar a integração, mapeamos junto com você os campos do seu retorno para o nosso padrão.
Identificação do Leilão
Título do leilão como será exibido na plataforma.
Número do processo judicial ou referência extrajudicial relacionada ao leilão.
Agenda do Leilão
Data e hora da primeira praça (formato ISO 8601, ex.: 2026-06-15T14:00:00-03:00).
Data e hora da segunda praça (formato ISO 8601, ex.: 2026-06-22T14:00:00-03:00).
Data e hora da terceira praça, quando o leilão tiver. Envie no mesmo formato ISO 8601. Omita o campo (ou envie null) quando o leilão tiver apenas duas praças.
Valores
Valor mínimo do lance na primeira praça (em reais, sem máscara).
Valor mínimo do lance na segunda praça (em reais, sem máscara).
Valor mínimo do lance na terceira praça. Obrigatório sempre que data_terceira_praca for enviada.
Valor de avaliação do imóvel (em reais, sem máscara). Usado pela plataforma para calcular o desconto real.
Localização
UF do imóvel em sigla (ex.: SP, MG, RJ).
Nome da cidade onde o imóvel está localizado.
Endereço completo do imóvel (rua, número, bairro, complemento, CEP).
Latitude do imóvel em decimal (ex.: -23.55052). Essencial para exibição no mapa.
Longitude do imóvel em decimal (ex.: -46.633308). Essencial para exibição no mapa.
Características do Imóvel
Tipo do bem (ex.: Apartamento, Casa, Comercial, Terreno, Rural).
Modalidade do leilão (ex.: Judicial, Extrajudicial, Venda Direta).
Área total do imóvel em metros quadrados.
Acesso e Documentação
URL pública do leilão no site do leiloeiro. Será usada como destino do clique.
URL pública do edital completo do leilão em PDF ou página HTML.
Descrição completa do imóvel: cômodos, vagas, ônus, ocupação e demais observações relevantes.
Array de URLs públicas das fotos do imóvel (mínimo 1 foto). Aceita JPG, PNG e WebP.
Como deve ser o JSON do seu endpoint
Resposta esperada no formato de array de objetos. Cada objeto representa um leilão ativo.
[
{
"titulo": "Apartamento 92m² · Vila Mariana · São Paulo/SP",
"numero_processo": "1001234-56.2025.8.26.0100",
"data_primeira_praca": "2026-06-15T14:00:00-03:00",
"data_segunda_praca": "2026-06-22T14:00:00-03:00",
"data_terceira_praca": "2026-06-29T14:00:00-03:00",
"lance_minimo_primeira_praca": 650000,
"lance_minimo_segunda_praca": 325000,
"lance_minimo_terceira_praca": 250000,
"avaliacao": 820000,
"estado": "SP",
"cidade": "São Paulo",
"endereco": "Rua Domingos de Morais, 1280, Vila Mariana, São Paulo/SP, 04009-002",
"latitude": -23.589501,
"longitude": -46.634410,
"tipo_bem": "Apartamento",
"tipo": "Judicial",
"metragem_m2": 92,
"link_leilao": "https://leiloeiro.com.br/leilao/1234",
"edital": "https://leiloeiro.com.br/edital/1234.pdf",
"descricao": "Apartamento de 92m², 3 dormitórios (1 suíte), 2 vagas, em condomínio com lazer completo. Imóvel desocupado.",
"fotos": [
"https://leiloeiro.com.br/fotos/1234-1.jpg",
"https://leiloeiro.com.br/fotos/1234-2.jpg",
"https://leiloeiro.com.br/fotos/1234-3.jpg"
]
}
]Regras para o endpoint funcionar bem
Endpoint público e estável
URL fixa, acessível sem autenticação ou com token simples (Bearer ou query param). Não use proxies, captcha ou bloqueios de IP que limitem requisições automáticas.
Resposta em JSON válido
Content-Type: application/json. Encoding UTF-8. Status HTTP 200 OK em caso de sucesso. Erros devem retornar 4xx/5xx com mensagem clara.
1 requisição diária
Nossa máquina consulta seu endpoint uma vez por dia, em horário de baixa carga (madrugada). Você não precisa enviar webhooks nem manter conexão aberta.
HTTPS obrigatório
Endpoint deve responder em HTTPS com certificado válido. Não aceitamos HTTP nem certificados auto-assinados em produção.
Já tem o endpoint pronto? Fale com nossa equipe
Se sua API já existe ou você precisa de ajuda para montar a integração, falamos diretamente com seu time técnico para configurar tudo em poucos dias.
CNPJ 36.133.974/0001-90
Av. Ayrton Senna da Silva, nº 2500, Monte Alto - SP
Pronto para integrar seu leilão à
maior plataforma do Brasil?
Mais de 60 mil investidores cadastrados aguardando novas oportunidades. Sua exposição começa no dia seguinte à integração.
Iniciar integração no WhatsApp