60 req/min
10.000 req/dia
Acesse 38 mil leilões via REST
Cobertura federal, estadual e municipal, classe de bens normalizada, Nota de Oportunidade e Radar Judicial expostos por endpoints versionados. Pensada para investidor com volume, imobiliária com equipe e escritórios com painel próprio.
Aviso
A API é a forma recomendada de integração por enquanto. O app mobile oficial (Android e iOS) consumindo a mesma API será lançado no terceiro trimestre de 2026.
Endpoints principais
| Método | Rota | Descrição |
|---|---|---|
| GET | /v1/items | Lista paginada de itens com filtros por classe, UF, cidade, faixa de lance e Nota. |
| GET | /v1/items/{id} | Detalhe completo de um item, incluindo metadados e laudo. |
| GET | /v1/items/{id}/score | Nota de Oportunidade detalhada, com peso por eixo e justificativa. |
| GET | /v1/search | Busca semântica em todo o catálogo aberto, com pgvector e filtros por classe. |
| POST | /v1/watchers | Cria, atualiza ou remove radares de monitoramento. |
| POST | /v1/webhooks | Registra um endpoint para receber eventos de novo item, mudança de Nota e mudança de status. |
Autenticação
Toda requisição precisa do cabeçalho Authorization: Bearer lai_live_.... Cada conta tem chaves distintas para ambientes de teste lai_test_ e produção lai_live_. Chaves comprometidas podem ser rotacionadas instantaneamente no painel.
Limites por plano
300 req/min
100.000 req/dia
600 req/min
100.000 req/dia
Excedente devolve HTTP 429 com cabeçalho Retry-After. Volume acima de Business pode ser combinado em contrato dedicado.
Como gerar sua chave
- 1. Entre na sua conta LeilôAI e abra a área de API no painel.
- 2. Crie uma chave nomeada (por integração) e copie no momento da geração. A chave aparece uma única vez.
- 3. Use a chave nas requisições no cabeçalho Authorization. Rotacione sempre que houver suspeita de vazamento.
Exemplo
curl -s "https://leiloai.com/api/v1/items?classe=imovel&uf=SP¬a_min=70&limit=20" \ -H "Authorization: Bearer lai_live_sua_chave_aqui" \ -H "Accept: application/json"
Resposta em JSON com paginação por cursor, fuso horário em America/Sao_Paulo e valores monetários em centavos para evitar arredondamento.
Aviso: a API do LeilôAI consolida dados públicos de editais, com garantia de melhor esforço na atualização. Não substitui a leitura do edital oficial nem a consulta jurídica caso a caso. O LeilôAI não intermedia pagamento, transferência ou retirada do bem.