アーカイブAPIの基本的な検索構造
Reddit Posts APIは公式のライブデータとは異なり、過去に保存された履歴データにアクセスするための独立したアーカイブサービスです。このAPIを使用すると、特定のサブレディット、ユーザー、またはキーワードに基づいて膨大な数の投稿を効率的に検索できます。各リクエストは個別にカウントされ、効率的なデータ抽出を可能にします。
最初の例はhttps://api.redditpostsapi.com/v1/posts?subreddit=photography&min_score=10&limit=3です。これはコミュニティ、最低スコア、最大3件という条件を示すもので、機材の投稿が3件あるという主張ではありません。応答の文章を確認し、機材に関係するものをローカルで分類してください。スコアを意見の正しさや機材品質の証明にせず、採用と除外の理由を記録します。
APIレスポンスはフラットな構造を持ち、スレッドの階層を再構築する必要がある場合もあります。投稿とコメントは個別に処理する必要があり、関連するフィールドに基づいてローカルでグループ化することができます。この設計は柔軟性を重視しており、分析ツールに合わせてデータの整形を容易にします。
タイムウィンドウ境界の制御とページネーション
fromとtoはUTCのYYYY-MM-DDで指定し、toの日を含みます。例えばfrom=2020-05-01&to=2020-05-31は境界を説明するだけの例で、その時期の記録が存在するという意味ではありません。次の期間は2020-06-01から始めれば境界日を二重に使わずに済みます。任意の日付条件であって時刻や分の指定ではないため、ローカル時間で分析する場合はUTC日との対応を説明してください。
結果はアーカイブ文書順で、日時、関連性、スコア順ではありません。1回100レコード、1クエリ100ページが上限で、反復しても全件取得の保証はありません。総数関係のeqは正確、gteは下限、unknownは不明で、nullの場合もあります。これは一致記録の件数でありページ数ではありません。正確な総数でも全件が保存された証明にはなりません。
受信したページを保存してからローカルの進捗を更新します。ページ番号の記録は遠隔データの固定位置ではなく、再開時に欠落や重複がない保証はありません。日付の分割も完全な取得を保証しません。保存した元応答、条件、取得時刻と変換ルールを残せば、その入力に対する分析を再検討できますが、将来の検索結果の不変性は確認できません。
スコアリングとステータス確認のポイント
検索結果のフィルタリングにおいて、min_scoreパラメータはスコアのソート順を制御するために使用されるのではなく、単なるフィルターとして機能します。これにより、指定した最低スコア以上の投稿を抽出できますが、結果がスコア順に並んでいるわけではありません。アーカイブの順序は依然としてドキュメント順序に基づいています。
システムステータスエンドポイントは、HTTPサーバーが応答可能であることを示す静的な情報であり、バックエンドの検索インデックスやアーカイブの完全性を確認するものではありません。このエンドポイントの使用は無料であり、クレジットを消費しません。つまり、サーバーが稼働していることは確認できますが、データが完全に利用可能であることは保証されない場合があります。
成功した取得は空でも1クレジットです。不正なリクエストは課金されず、取得元の失敗は予約分を返還します。応答を失ったクライアントには課金済み成功が見えない場合があり、成功した再試行は別に課金されます。空の応答から、記録が過去に存在しなかったと結論しないでください。Authorization: Bearer YOUR_API_KEYまたはX-API-Key: YOUR_API_KEYを使えます。資料と価格を確認し、キー管理はキー取得ページのパネルで行います。
