revisedDate で速報の更新を追跡する

revisedDate で速報の更新を追跡する

ニュースは静的ではありません。あるニュースが報じられた後、出版社が数値を訂正したり、コメントを追加 したり、事態の進展に合わせて見出しを更新したりします。公開時刻だけを追っていると、こうした改訂を 見逃します。finlight は revisedDate を公開しているので、最初の公開後に変化した記事を捉えられます。

最新の改訂順に並べる

最近更新された記事を浮かび上がらせるには、POST /v2/articles で revisedDate を基準に並べ替えます。

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
  }'

revisedDate で並べ替えると、各記事には元の publishDate と revisedDate の両方が含まれます。

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

実際に何が変わったかを検出する

2 つのタイムスタンプを比較すると、どの記事が更新されたか、そして公開からどれくらい経って更新されたかが 分かります。

• revisedDate が publishDate より後であれば、その記事は改訂されています。
• 両者の差は更新がどれだけ新しいかを示し、急展開する記事をフラグ付けするのに役立ちます。

revisedDate で並べ替え、最後に見た revisedDate を記憶しておくシンプルなポーリングループを組めば、 前回の実行以降のすべての改訂を、変化のない記事を再処理することなく拾い上げられます。

知っておくとよいこと

• revisedDate は ニュース提供元 が最後に記事を改訂した時刻を反映し、finlight がそれを取り込んだ 時刻ではありません。finlight の取り込み時刻が欲しい場合は createdAt を使ってください。
• このフィールドは revisedDate で並べ替えたときに返されます。お好みの任意のフィルター（tickers、 categories、query）と組み合わせられます。
• 公式の finlight-client SDK は現在、publishDate と createdAt による並べ替えを公開しています。 今すぐ revisedDate で並べ替えるには、上記のように REST エンドポイントを直接呼び出してください。

次に読むもの

• 高度なフィルタリング：精密なクエリ。
• 完全なドキュメント。

無料 API キーを取得する →