Avisar quando entra um leilão do que você procura
Uma busca por palavras e estado, guardando os ids já vistos, avisa cada lote novo no mesmo dia em que ele aparece na fonte oficial.
Publicado em .
Fontes oficiais: o Sistema de Leilão Eletrônico da Receita Federal e o Portal Nacional de Contratações Públicas.
Quem procura um bem em leilão perde tempo abrindo o site de cada órgão. A API junta as fontes oficiais num lugar só, e um laço curto basta para saber o que entrou.
A busca
curl "https://leiloes.wortic.com/v1/leiloes?q=hilux&uf=RS"
Cada lote traz id, descricao, avaliacao, lance_minimo, encerramento, aberto, a fonte e o link do edital.
O código
const vistos = new Set(JSON.parse(localStorage.getItem("vistos") ?? "[]"));
export async function novos(busca) {
const r = await fetch(`https://leiloes.wortic.com/v1/leiloes?${new URLSearchParams(busca)}`);
if (!r.ok) return [];
const { leiloes } = await r.json();
const frescos = leiloes.filter((l) => l.aberto && !vistos.has(l.id));
frescos.forEach((l) => vistos.add(l.id));
localStorage.setItem("vistos", JSON.stringify([...vistos]));
return frescos;
}
for (const l of await novos({ q: "hilux", uf: "RS" }))
console.log(l.descricao, l.avaliacao, l.encerramento, l.link);
Guarde o id, não a posição na lista: a ordem muda conforme os leilões encerram.
Perguntas e respostas
Com que frequência vale consultar?
As fontes são lidas algumas vezes por dia; a data da última leitura de cada uma está em /v1/tipos. Uma consulta por hora para cada busca é mais que suficiente.
A busca por palavras entende acento e plural?
Ela ignora acento e maiúscula e ordena pela relevância, com o campo nota em cada lote. Para um termo bem específico, como um modelo de carro, use a palavra exata.
Dá para avisar só leilões que ainda recebem lance?
Sim: o campo aberto diz se o lote ainda recebe lance. Os abertos vêm primeiro na lista, pela data de encerramento.
Todos os guias · Documentação com exemplos · openapi.json · Versão para IA