API pública
Acesse os dados do Monitor do STF por uma API REST gratuita, sem cadastro e sem chave. Endpoints JSON pra usar em pesquisa, jornalismo de dados, dashboards e estudos acadêmicos.
No banco agora
Recorte oficial: desde 06/09/2026. Coleta automática duas vezes ao dia. Snapshot público regenerado ao fim de cada coleta.
Como começar
Um exemplo rápido — retorna o JSON com os totais do banco.
curl -s https://stf.sapienslabs.com.br/api/v1/statsEndpoints
Todos são GET, retornam JSON com envelope { "data": ..., "meta": {...} }
e respeitam o recorte oficial de 06/09/2026.
| Caminho | O que retorna |
|---|---|
/api/v1/ |
Índice: lista os caminhos disponíveis e a licença. |
/api/v1/stats |
Totais gerais (artigos, entidades, veículos) e timestamp da última coleta. |
/api/v1/entidades |
Lista as entidades monitoradas — a Corte e os ministros — com volume e tom. |
/api/v1/entidades/{slug} |
Detalhe de uma entidade: KPIs, distribuição de sentimento, top fontes e tópicos. Para a Corte, inclui o recorte só institucional e o selo de tom provisório. |
/api/v1/entidades/{slug}/articles |
Matérias verificadas de uma entidade, paginadas. Aceita os mesmos filtros de /api/v1/articles (menos entidade, já fixa nesta entidade). |
/api/v1/articles |
Lista paginada de artigos. Filtros: entidade, desde, ate, veiculo, genero, tom (positive, neutral ou negative), page, per_page (até 100). |
/api/v1/topics |
Tópicos extraídos, com contagem: até os 20 mais frequentes, e meta.note avisa quando a lista foi truncada. Filtros: entidade, period. |
/api/v1/veiculos |
Mapa dos veículos: rótulo editorial, proveniência, sede, dono, artigos, justificativa e fontes. Só perfis de proveniência aprovada e com ao menos um artigo. Filtros: q, rotulo, uf, status. |
/api/v1/series/tom |
Série temporal de tom. entidade opcional, period. |
/api/v1/series/volume |
Série temporal de volume. entidade opcional, period. |
/veiculos.csv |
Dataset do mapa dos veículos (só perfis revisados): rótulo, eixo, sede, dono, artigos, justificativa, fontes. UTF-8, vírgula. Rubrica em /veiculos/rubrica. |
/veiculos.json |
O mesmo dataset em JSON, com meta (licença, atribuição, data de geração). |
O que a API expõe — e o que não expõe
O limite entre dado derivado, aberto por natureza, e conteúdo de terceiro, que a API não reproduz.
Expõe
- Dados derivados do projeto: tom por entidade, tópicos, classificação editorial e cluster Zeitgeist.
- Metadados do artigo: título, URL original (link de volta pra origem), fonte, data de publicação.
- Trecho curto (
description) só no detalhe de cada artigo.
Não expõe
- Corpo dos artigos. Pra ler na íntegra, siga o
urlde cada artigo até o veículo original. - Endpoints de escrita — a API é estritamente
GET. - Dados pessoais ou de navegação dos visitantes do painel.
Limites, cache e versionamento
Como a API trata autenticação, cache e mudanças de contrato ao longo do tempo.
Sem autenticação. Não tem chave, não tem cadastro, não tem cota individual.
Cache de 5 minutos (Cache-Control: public, max-age=300).
O snapshot do banco é regenerado ao fim de cada coleta.
Versionamento. Mudanças retro-incompatíveis vão pra
/api/v2/. A v1 fica estável; alterações são aditivas (novos
endpoints, novos campos opcionais).
Erros estruturados. Recursos inexistentes retornam
HTTP 404 com JSON { "detail": "..." }. desde/ate
fora do formato YYYY-MM-DD retornam HTTP 400. page menor que 1
e per_page fora de 1–100 retornam HTTP 422, com o campo recusado em
detail.
Licença e atribuição
Os termos sob os quais os dados podem ser reutilizados, e como creditar a fonte.
Dados disponibilizados sob Creative Commons Atribuição 4.0 (CC BY 4.0). Você pode copiar, redistribuir, transformar e construir em cima — inclusive pra uso comercial — desde que dê o crédito apropriado.
Atribuição sugerida:
SapiensLabs — Monitor do STF (stf.sapienslabs.com.br) — CC BY 4.0
Os dados derivados (tom, tópicos, classificações, série temporal) são produção própria do projeto. Os links apontam pros veículos originais — cite-os quando reproduzir conteúdo deles.
Quer contribuir, reportar erro ou conversar sobre o projeto? Mande email pra leonardo@sapienslabs.com.br.