Wortic

Wortic Leilões / 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.

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