Acompanhe atualizações de notícias com revisedDate

Acompanhe atualizações de notícias com revisedDate

Notícias não são estáticas. Uma matéria estoura e, em seguida, o veículo corrige um número, acrescenta uma citação ou atualiza a manchete à medida que a situação se desenrola. Se você só acompanha o horário de publicação, vai perder essas revisões. A finlight expõe um revisedDate para que você capte matérias que mudaram depois de publicadas pela primeira vez.

Ordene pela revisão mais recente

Para trazer à tona artigos atualizados recentemente, ordene por revisedDate em POST /v2/articles:

curl -X POST https://api.finlight.me/v2/articles \
  -H "X-API-KEY: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "tickers": ["AAPL"],
    "orderBy": "revisedDate",
    "order": "DESC",
    "pageSize": 20
  }'

Quando você ordena por revisedDate, cada artigo inclui tanto o seu publishDate original quanto o seu revisedDate:

{
  "title": "Apple expands services guidance after earnings call",
  "publishDate": "2026-06-18T09:00:00.000Z",
  "revisedDate": "2026-06-18T14:30:00.000Z"
}

Detectando o que de fato mudou

Comparar os dois timestamps mostra quais matérias foram atualizadas e quanto tempo depois da publicação:

• Se o revisedDate for posterior ao publishDate, a matéria foi revisada.
• O intervalo entre eles indica quão recente é a atualização, o que é útil para sinalizar matérias em rápida evolução.

Um loop de polling simples que ordena por revisedDate e lembra o último revisedDate que viu vai captar toda revisão desde a execução anterior, sem reprocessar artigos que não mudaram.

Bom saber

• O revisedDate reflete quando o provedor de notícias revisou o artigo pela última vez, não quando a finlight o ingeriu. Use createdAt se você quiser o horário de ingestão da finlight.
• O campo é retornado quando você ordena por revisedDate. Combine-o com quaisquer filtros que preferir (tickers, categories, query).
• Os SDKs oficiais finlight-client atualmente expõem ordenação por publishDate e createdAt. Para ordenar por revisedDate hoje, chame o endpoint REST diretamente como mostrado acima.

Para onde ir agora

• Filtragem avançada: consultas precisas.
• Documentação completa.

Obtenha sua API key gratuita →