Wortic

Wortic Leilões / Guias

Percorrer a lista inteira com o cursor

Cada página traz até 50 lotes e o campo proximo. Mande esse valor em cursor para pegar a página seguinte; quando proximo vem nulo, a lista acabou.

Publicado em .

Fontes oficiais: o Sistema de Leilão Eletrônico da Receita Federal e o Portal Nacional de Contratações Públicas.

A lista nunca devolve tudo de uma vez. O cursor é o jeito seguro de ir até o fim sem pular nem repetir lote.

A resposta

{"total": 200, "limite": 50, "proximo": "50", "leiloes": [ ... ]}

Na última página, proximo vem null.

{"total": 200, "limite": 50, "proximo": null, "leiloes": [ ... ]}

O código

export async function* todos(busca) {
  let cursor;
  do {
    const q = new URLSearchParams({ ...busca, ...(cursor && { cursor }) });
    const r = await fetch(`https://leiloes.wortic.com/v1/leiloes?${q}`);
    if (!r.ok) throw new Error(`HTTP ${r.status}`);
    const pagina = await r.json();
    yield* pagina.leiloes;
    cursor = pagina.proximo;
    await new Promise((ok) => setTimeout(ok, 1100));
  } while (cursor);
}

for await (const l of todos({ tipo: "receita", uf: "SP" })) console.log(l.id, l.descricao);

A pausa de pouco mais de 1 segundo deixa o laço abaixo de 60 pedidos por minuto, e ele nunca recebe 429.

Perguntas e respostas

O que é o campo total?

Quantos lotes a busca acha ao todo, para você mostrar o número ou uma barra de progresso.

Posso pedir mais de 50 por página?

Sem chave, o teto é 50. Com a chave do plano Pro, o limite vai até 1.000 por página, e dá para pedir a resposta em CSV ou jsonW.

Percorrer a base inteira conta para o limite?

Sim. Cada página é um pedido; sem chave, fique abaixo de 60 por minuto. Para volume, use a chave do plano Pro.

Todos os guias · Documentação com exemplos · openapi.json · Versão para IA