Keyword Logs API

概要

検索キーワードのログを取得するAPIです。Cloudflare Pages Functions上で動作し、Cloudflare KVに蓄積されたキーワードログデータを返します。

GET /pj/zpaper/api/keyword-logs

Cloudflare Pages Functionsのファイルベースルーティングにより、functions/pj/zpaper/api/keyword-logs.tsが処理します。

パラメータ	型	必須	デフォルト	説明
`from`	string	いいえ	30日前	取得範囲の開始日時（ISO 8601形式）
`to`	string	いいえ	現在時刻	取得範囲の終了日時（ISO 8601形式）
`limit`	number	いいえ	1000	最大取得件数（上限5000）

{
  "logs": [
    {
      "keyword": "Claude Code",
      "timestamp": "2026-03-01T12:34:56.789Z",
      "resultCount": 5
    }
  ],
  "total": 42
}

フィールド	型	説明
`logs`	array	ログエントリの配列（`timestamp`の降順）
`total`	number	フィルタ条件に一致するエントリの総数（limit適用前）

各ログエントリのフィールドは以下の通りです。

Content-Type: application/json
Cache-Control: no-cache
Access-Control-Allow-Origin: *

キーワードログはCloudflare KVのKEYWORD_LOGSネームスペースに保存されます。wrangler.tomlでバインディングが設定されています。

検索APIが検索を実行した際に、結果が1件以上あればcontext.waitUntil()を使用してfire-and-forget方式で非同期に書き込みます。

このAPIはkv.list()でカーソルベースのページネーションで全キーを列挙し、各エントリをkv.get()で取得します。日付範囲でフィルタリングした後、timestampの降順でソートし、limit件に制限して返します。

ログデータを可視化するダッシュボードアプリが用意されています。詳細はキーワード検索を参照してください。