結果を読む前に観測単位を決める
まず確認可能な判断を書きます。replicationに一致して受信したr/scienceの記録のうち、研究の追試を扱うものはどれか。観測単位を一記録とし、投稿、コメント、両方のどれを扱うか先に決めます。検索は候補テキストを選び、意味の分類は手元で行います。単語の一致は科学的結果の再現成功を示すものではありません。
研究の問い、記録種別、コミュニティ、期間、採用規則を先に書きます。Reddit API Labsは独立した過去アーカイブで、公式Redditやライブデータではありません。OAuth、書き込み、投票、メッセージはありません。取得記録は全利用者の無作為標本ではありません。文書化された方法でもデータが将来常に同じになるとは限りません。同じ保存データで分析コードを再実行することと、APIから新たに取得することは別です。プロトコルでは検証したい操作を明示し、結論の範囲も定めます。
実行した検索条件をそのまま記録する
GET https://api.redditapilabs.com/v1/search?q=replication&subreddit=science&limit=3は開始例で、三件を保証しません。qは検索語、subredditはコミュニティ、limitは最大件数です。replication検索は無作為抽出ではありません。fromとtoはUTCのYYYY-MM-DDでtoは一日全体を含み、kindはpostかcommentです。min_scoreは最低条件で品質、重要性や並べ替えの検査ではありません。低スコアを除く選択効果を説明し、条件を後から変えた場合は別の実験段階として残してください。
replication crisisを試すときは、検索条件の変更を追記します。qはtitleとtextを検索し、一致対象のフィールド内でand条件を適用します。タイトルの語と本文の別の語を単純につなぐ動作ではありません。広い条件と狭い条件の応答を別に残してください。どちらも追試についての語彙を網羅するわけではありません。
Authorization: Bearer YOUR_API_KEYかX-API-Key: YOUR_API_KEYを使います。両方有効で、このドメインのアーカイブキーを使いReddit OAuthトークンではありません。秘密はサーバーで守りプロトコルやログから除きます。/v1/postsは投稿、/v1/commentsはコメントでidは一覧のフィルターではなく、/v1/item?id=...は既知の一項目です。/v1/subreddits?prefix=...はコミュニティ探索に使えますが完全なアルファベット順一覧や正確な全体集計ではありません。条件は実行した要求から記録し、受信した応答に結び付けます。
原文を残して意味を分類する
手元の分類表に、存在する場合の記録ID、分類、判断理由を書きます。初期分類には「研究の追試」「生物学的複製」「文脈不足」などを使えます。これは研究者の注釈で、APIが返す分類フィールドではありません。曖昧な事例は無理に確定せず検討用に残し、原文と分析用に整えたテキストを分けて保存します。
元のJSON、要求時刻、ページ、状態コード、保存結果を自分の環境で残せます。自分で計算したファイルハッシュは保管ファイルの同一性確認であり、サーバーの版や不変性証明ではありません。コードの版、依存関係、前処理と分類の規則を書き、乱数を使う分析ならその設定も残します。ローカル入力の検証と新しいアーカイブ検索は異なります。コードとデータを保存しても科学的結論や全環境での同一出力が自動で保証されるわけではありません。取得後の変換も元データと区別します。
比較では一つの条件だけを変える
最初は保存した入力を固定し、分類規則だけを変えて比較します。どの判断がなぜ変わったかを記します。後日の取得は別の実行記録にしてください。入力と規則を同時に変更した場合、分類件数の差を片方の変更だけに帰することはできません。
応答は平坦な記録で、parent_idとlink_idによる関係整理は任意です。閲覧や集計にツリーは不要で欠けた親も復元されません。文書順は日時順、関連度順、スコア順ではありません。一要求100件、一クエリ100ページが上限です。eqは正確な総数、gteは下限、unknownまたはnullは信頼できる総数が不明です。正確な数でも全件保存は証明しません。期間分割と重複除去も完全で一意な取得を保証しません。ページ、停止理由、欠損項目をプロトコルへ記載してください。
停止理由と未解決の事例を報告する
最後に、引数、受信ページ、採用記録、除外理由、未解決の意味をまとめます。停止理由と件数を出した規則の版も書きます。結論はこの材料に限定してください。不明な総数、欠けた文脈、アーカイブの欠落は、コミュニティがその話題を論じなかった証拠にはなりません。
成功した取得は空でも一クレジット、1,000成功で$1です。無効な要求は差し引かれず上流失敗では予約分が戻ります。サーバー成功後の応答喪失では成功した再試行が追加費用です。400は引数、401はキー、402は残高、429は頻度を確認して試行を限定します。/v1/statusは公開非課金でも静的範囲とHTTP応答のみで、検索、記録、キー、残高は検査しません。クレジット返還はデータ整合性を証明せず、永久保存や性能も保証されません。利用では法と第三者の権利も考慮します。
