No ar · coleta às 7h e às 18h30 dados de 19/11/2026, 07:06
PROJETO · DADOS ABERTOS

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

36.438
matérias
11
entidades
1.414
veículos
19/11/2026 07:06
última coleta

Recorte oficial: desde 06/09/2026. Coleta automática duas vezes ao dia, às 7h e às 18h30. 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/stats

O contrato completo da API (OpenAPI 3) está em /api/v1/openapi.json.

Endpoints

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 (matérias, 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 matérias. 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 (blogs de pessoa física saem sem dono, justificativa e fontes). Só perfis de proveniência aprovada e com ao menos uma matéria. 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 (blogs de pessoa física sem dono, justificativa e 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).

Arquivo aberto

O acervo inteiro sem paginar: dois arquivos CSV comprimidos (.csv.gz, UTF-8), regenerados ao fim de cada coleta, com o recorte oficial de 06/09/2026. As matérias trazem id, published_at, source_canonical, title, url, genre e editorial_lean_detail; os pares trazem as menções aceitas (article_id, entidade, sentiment, sentiment_score, sentiment_provisional), sempre de matérias presentes no arquivo de matérias. O texto das matérias não vai. O manifest.json informa a data da geração, a última coleta, o número de linhas, o tamanho e o sha256 de cada arquivo.

ArquivoLinhasTamanho
/dados/stf-materias.csv.gz 36438 2.3 MB
/dados/stf-pares.csv.gz 73856 0.2 MB

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 da matéria: título, URL original (link de volta pra origem), fonte, data de publicação.
  • Trecho curto (description) só no detalhe de cada matéria.

Não expõe

  • Corpo das matérias. Pra ler na íntegra, siga o url de cada matéria 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.