# 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. Endereço: https://leiloes.wortic.com/guias/avisar-leilao-novo Fontes dos dados: Receita Federal, PNCP, Caixa e Diário de Justiça Eletrônico Nacional, pela Wortic. Wortic Leilões (/) / Guias (/guias/) 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. 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 (/guias/) · Documentação com exemplos (/docs) · openapi.json (/openapi.json) · Versão para IA (/llms.txt)