結果を見る前に比較方法を書く
具体的には、AskSocialScienceで科学的な裏付けのある説明がどのように求められるかを連続する2週間で比較します。分析単位は最初の投稿です。疑問文や研究への言及がない文章も採用するのかを、先に決めてください。目立つ一例を見た後で、もう一方の週に適用する基準が無意識に変わらないよう、取得前に判断を書き残します。
fromとtoはUTCの日単位で、最終日全体を含みます。現地の暦で決めた期間をUTC境界へどう変換したか記録してください。時間単位のフィルターはありません。必要なら広めのUTC日付を取得し、実際に返された時刻をローカルで確認します。この処理は欠けた記録を補わず、完全な取得を証明しません。
各週のUTC境界を指定する
GET https://api.redditcollector.com/v1/posts?subreddit=AskSocialScience&limit=3に、最初の例示期間として&from=2025-03-01&to=2025-03-07を追加します。次の期間はfrom=2025-03-08&to=2025-03-14とし、page=1から始め直します。この日付は練習用の設定で、既知の収録範囲ではありません。形式はUTCのYYYY-MM-DDで、toの日全体を含みます。ホームの例だけでは日付は制限されません。2期間で経路、コミュニティ、採用基準を共通にし、日付境界を変えます。
一要求100件、一クエリ100ページは上限で、必ず得られる量ではありません。各ページは別の呼び出しです。文書順は時系列、関連度、スコア順ではなく、最後のレコードの日付がそれ以前の全件取得を証明するわけではありません。eqは正確な総数、gteは下限、unknownまたはnullは総数不明です。ページ反復、狭い日付への分割、重複除去で全一致の取得は証明できません。実際の保存数、確認したページ、終了理由を記録します。空の成功結果も、その時点のそのクエリの結果であり、期間中に議論がなかったことの証拠ではありません。
検索条件と研究上の分類を分ける
初めはqやmin_scoreを使わずに表現を確認します。後でqが必要になった場合、検索対象はtitleとtextで、検索語はすべて一方のフィールド内で一致する必要があります。タイトルと本文に語が分かれているだけでは条件を満たしません。min_scoreはしきい値の指定であり、品質や新しさでの順位付けではありません。研究用の分類と除外理由は元の項目とは別にローカルで記録します。アーカイブがその評価を付けるわけではありません。
収集を止めた理由を残す
実際に返された日時、識別子、コミュニティの項目を確認します。研究期間、UTC取得日時、ローカルファイルの版を分け、欠けた日付や文章を推測で埋めないでください。関係分析が必要ならparent_idやlink_idで任意の整理はできますが、これらは検索引数ではなく、存在しない親を復元しません。平坦な記録の閲覧や分類には会話ツリーは不要です。同一文章や識別子で重複を除いた場合は、方法と除外件数を説明します。手元の資料で検査した範囲だけを報告し、見えない欠落まで解決したとは述べないでください。
成功した空の取得も一クレジットを使います。無効な要求は差し引かれず、上流失敗では予約分が戻ります。クライアントの時間切れはサーバー失敗の証拠ではなく、成功した再試行は追加費用になる場合があります。400は引数、401はキー、402は残高、429は頻度を確認します。/v1/statusは非課金でも、静的範囲とHTTP応答以外の記録、キー、検索基盤を検査しません。将来の同一取得、永久保存、完全性は保証されません。最終報告では期間の選択理由、実際の範囲、期間ごとの欠落、第三者の権利への配慮を研究結果と区別して説明してください。
読み手が追える方法の記録を作る
最後に、なぜこの2週間と最初の投稿を選んだか、使ったフィルターと終了理由を説明します。取得件数と分析採用件数を分け、欠けた日付や文脈も記載します。期間の長さとリクエスト予算をそろえても、代表標本にはなりません。読んだ投稿の主題が違うという観察はその資料についてのもので、それだけでコミュニティ全体の変化は証明できません。
