質問を集め、選んだ理由を記録する

AskSocialScienceを対象とするRedditデータ収集APIです。研究課題を定め、3件の投稿を確認し、2週間を比較するための採用基準と除外の判断を記録します。

リクエスト例

cURL

curl --fail-with-body -H "Authorization: Bearer YOUR_API_KEY" "https://api.redditcollector.com/v1/posts?subreddit=AskSocialScience&limit=3"

何を研究上の質問として数えるか

AskSocialScienceで、社会科学の知見に基づく説明をどのように求めているかを2週間分の投稿で調べるとします。分析単位は最初の投稿で、その下の返信すべてではありません。明確な疑問文がなくても研究の紹介を求めていれば採用するのか、先に決めます。Reddit Collectorは独立した過去のRedditアーカイブからデータを収集するAPIです。公式サービスではなく、ライブデータも提供しません。この作業で得られるのは、選択の判断を記録した限定的な投稿の集まりです。質問の表現を検討する資料にはなりますが、コミュニティ全体の意見を測るものではありません。

GETの例はhttps://api.redditcollector.com/v1/posts?subreddit=AskSocialScience&limit=3です。subredditはコミュニティを選び、limit=3は最大三件を要求します。三件が必ず返るという意味ではありません。Authorization: Bearer YOUR_API_KEYまたはX-API-Key: YOUR_API_KEYが使えます。YOUR_API_KEYはプレースホルダーで、実際のキーは信頼できるサーバーで設定し、共有する研究ノートには残しません。Reddit OAuthトークンではありません。架空の投稿や未実行の応答を取得結果として示しません。この例には日付条件がないため、特定期間の資料とは呼べません。期間を決めた収集ではfromとtoを追加します。

対象期間と取得日時を分けて考える

期間を選んだ理由、実際のフィルター、UTCでの取得日時を別々に記録します。fromとtoはUTCのYYYY-MM-DDで、toは指定日全体を含みます。現地時刻で定めた出来事を扱う場合、UTCの日付では広めの範囲が必要になることがあります。未対応の時間単位フィルターを作らないでください。必要な時刻項目が実際に返る場合は、ローカルで狭い境界を確認して、その規則を説明できます。取得日時は投稿日時や収録日時ではありません。別の日に同じクエリを実行しても同じ記録や順序が返る保証はありません。

文書順は時系列、関連度、スコア順ではありません。最初のページを最古、最新、無作為標本と扱わないでください。min_scoreは最低スコアの条件で、低スコアの文章を除くと資料の構成が変わります。応答は平坦なレコードなので、そのまま閲覧や分類ができます。会話関係の整理は任意で、parent_idやlink_idがあっても欠けた親や会話全体を復元するものではありません。投稿とコメントは別の分析単位です。何を集めたか、欠けた文脈をどう扱ったかを研究方法に記載してください。APIが社会調査の分析や検証済みの知見を提供するわけではありません。

除外する投稿を意識して決める

最初の確認では、投稿者の語彙を知る余地を残します。想定したキーワードを使わずに研究内容を説明している投稿もあり得ます。スコアのしきい値は、あまり知られていない質問を除外するかもしれません。qやmin_scoreを追加する前に、何が外れ、それが研究目的にどう関係するかを説明してください。読んだ後で基準を変える場合は計画を別版として残し、各資料にどの基準が適用されたか分かるようにします。

2週間を比較する際は同じ採用基準を用い、それぞれの期間に使うリクエスト数の上限を先に決めます。同じ予算でも同じ範囲を取得できるとは限りません。一方がページ上限に達し、他方は少数しか返らなければ、その両方を報告します。取得件数の差を、そのまま実際の投稿活動の差と解釈しないでください。

計画を実際の収集につなげる

応答と一緒に、コミュニティ、日付、分析単位、除外基準、終了理由を保存します。ガイドではこの計画を2つのUTC期間に置き換え、ドキュメントでは引数を確認できます。キーのページでアクセスを準備してください。空の結果も含め成功1,000回で$1、最低$50の追加で有料50,000クレジットです。リクエスト数と分析に採用した投稿数は別々に数えます。