Notícias, média e eventos de centenas de fontes, numa só API.
O OSNOdata recolhe, guarda e disponibiliza: televisão transcrita, jornais lidos até ao fim, registos públicos e o que lhe enviarem, servidos por API a quem tem uma chave. O que cada cliente faz com os dados é com ele.
Fotografia: CGP Grey (CC BY 2.0)
Três formas de entrar, uma forma de ler.
Os clientes lêem os dados da mesma maneira, venham de onde vierem: pedindo-os, ou com um stream aberto a receber cada item quando chega.
Por pedido
Fontes lidas com horário: feeds e sites (também os que só mostram o conteúdo depois de correr o JavaScript), podcasts, vídeos, programas de televisão, registos públicos e edições de jornais.
Streams
Fontes que nunca param: canais de televisão gravados o dia todo em blocos, transcritos e juntos nos programas da grelha, e contas do Bluesky seguidas ao vivo.
Push
Fontes que enviam o que têm: newsletters e listas de email para [email protected], webhooks de entrada de qualquer serviço e envios pela API.
Algumas das fontes que já lê
- RSS e Atom
- Google News
- Sites e WordPress
- Páginas desenhadas por JavaScript
- Canais públicos do Telegram
- Bluesky
- Podcasts
- YouTube
- RTP Play
- TVI Player e CNN Portugal
- SIC e Expresso
- CMTV e NOW
- Canais de TV em directo
- Diário da República
- Contratos públicos (BASE)
- Parlamento
- Tribunais (DGSI)
- Tribunal Constitucional
- Entidade para a Transparência
- IFAP
- Portugal 2030
- Portal das Eleições
- BORME
- BODACC
- Edições de jornais em PDF
- Primeiras páginas
- Webhooks de entrada
Jornais e documentos, lidos até ao fim.
Uma edição inteira em PDF entra e sai partida em artigos. PDF, Word, PowerPoint, Excel, CSV e imagens são lidos em páginas, blocos e tabelas, com OCR quando é preciso.
- As primeiras páginas do dia, nacionais, regionais, de desporto e de economia, lidas por OCR.
- Televisão e rádio transcritas, partidas em peças, com o resumo de cada programa.
- Os documentos que um email ou um artigo trazem entram como itens de pleno direito.
Uma só porta de entrada.
Tudo o que vira item passa pelo mesmo núcleo, o Ingest, seja um endereço, um ficheiro, um texto, áudio ou vídeo. Cada passo guarda o seu resultado, por isso uma falha repete só esse passo.
- Resolver
- Extrair
- OCR
- Transcrever
- Peças
- Resumo
- Embeddings
No painel há a caixa Adicionar; pela API, POST /v1/ingest, com um ensaio que mostra o que aconteceria sem guardar nada.
Pedir, pesquisar, ou receber em casa.
Todos os pedidos vão para api.osnodata.com, respondem em JSON e levam a chave do cliente no cabeçalho Authorization.
Itens
Navegar do mais recente com um cursor, ou sincronizar tudo o que mudou desde um seq, sem perder nada.
GET /v1/itemsPesquisa semântica
Por palavras, por sentido ou pelas duas juntas, com o excerto que corresponde e os destaques.
GET /v1/searchStream (SSE)
Server-Sent Events: cada item à medida que chega, retomando onde ficou.
GET /v1/streamWebhooks
Um POST assinado com os itens novos para um endereço seu, repetido quando falha.
POST /v1/webhooksHistórias
A mesma notícia contada por várias fontes, agrupada pela semelhança do que dizem.
GET /v1/storiesClips
Um excerto de um programa ou episódio, até dez minutos, cortado em segundo plano.
POST /v1/items/:id/clip
curl "https://api.osnodata.com/v1/items?kind=media&limit=20" \
-H "Authorization: Bearer $OSNODATA_KEY"Restrições e direitos.
Algumas fontes trazem dados pessoais, outras conteúdo com direitos de autor. Cada item leva as etiquetas de restrição da sua fonte e as suas, e cada etiqueta tem uma política que diz o que recebe uma chave sem o direito correspondente.
Os direitos são dados a cada chave por um administrador, e uma chave nova não tem nenhum. As leituras de itens com etiquetas auditadas ficam registadas.
Esconder
O item não aparece.
Redigir
O item aparece sem alguns campos, como o texto ou a média. Título, ligação, fonte e datas ficam sempre.
Permitir
O item vem inteiro.
Comece pela documentação.
Autenticação, filtros, stream, webhooks e exemplos em curl, numa só página.
Fotografia: The Modern Polymath (CC BY-SA 4.0)