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