Reddit Posts API
Reddit Posts API

カメラの名前より、何に困っているかを読む

photographyの過去の投稿から、機材名の背後にある質問を読み取ります。引用と採用理由を残し、自分の編集用資料として整理するための入口です。

APIキーを取得

リクエスト例

cURL

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

おすすめ一覧を作る前に、読む資料をそろえる

レンズ名が出てくる投稿でも、購入を勧めているとは限りません。露出の相談、手持ちのカメラの使い方、使ってみた感想では、記事に使う意味が違います。まずその違いを読み分けましょう。Reddit Posts APIが提供するのは過去の投稿レコードです。編集上の採用判断や機材の評価は、自分で行う作業になります。Redditとは独立したアーカイブであり、公式サービスやライブの観測ではありません。

最初の例はhttps://api.redditpostsapi.com/v1/posts?subreddit=photography&min_score=10&limit=3です。subredditは対象、min_scoreは最低スコア、limitは最大3件を指定します。写真機材に関する3件があるという意味ではなく、別の話題も含まれ得ます。応答の文章を読んで機材に関するものをローカルで分類してください。スコアは製品の品質や意見の正しさを保証しません。

採用した一文と、その理由を一緒に残す

利用できるタイトルと本文を合わせて読み、ローカルのメモにレコードの識別子、短い引用、機材名、採用または除外の理由を記します。暗い室内のポートレートについての質問でも、答えるべきなのは新しいレンズではなく撮影方法かもしれません。これは読み方の例であり、実際にその投稿が見つかったという主張ではありません。

「購入相談」「撮影技術」「使用経験」「文脈不足」などの分類は、編集者が決める項目です。APIが付ける評価ではありません。本文が欠けていたら、書き手の意見を推測せずに不足を明記します。元の応答と短く編集した引用を分けて保存すれば、別の読者が判断の根拠を確認できます。引用だけを見て製品への賛否を決めず、質問の目的や条件も読める範囲で記録してください。

スコアと日付は、資料の選び方を表す

min_score=10は数値の下限を指定するフィルターです。優れた助言から並べたり、製品の品質を判定したりするものではありません。結果は_docの文書順で、日時、関連性、スコア順ではありません。最初の3件は少量の読み物であって、photographyを代表する三つの意見ではないのです。

別の下限を試すなら条件の違う資料として分け、変更理由を記します。異なる条件のファイルを、同じ選び方をした一つの標本として混ぜないでください。自分が読んだ投稿の分類件数は示せますが、コミュニティ全体の需要、市場シェア、写真家全般の好みを測定したことにはなりません。

期間を限定する場合、fromとtoはcreated_utcに対するUTCのYYYY-MM-DDです。toの一日全体を含み、取得した日時を絞る条件ではありません。隣接する期間の組み方はガイドで確認できます。読むページ数も先に決め、返ってきた資料の範囲だけで解釈してください。

編集者に渡すのは、判断をたどれる資料

識別子、引用、除外理由、まだ答えられない質問をまとめて渡します。次に何を調べるかの手がかりになっても、機材ランキングやコミュニティ全体の分析にはなりません。空の成功応答と失敗は区別しますが、どちらも新しい引用文を提供しません。ページをたどっても完全な取得は保証されず、後日の検索が同じレコードを返すとも限りません。

キー取得ページはアクセスと残高、ドキュメントはフィルター、料金ページは予算を説明します。成功した取得は空でも1クレジットを使います。追加ページの前に手元の文章を読み、どの疑問に資料が足りないかを確かめましょう。保存した引用の比較やラベルの修正だけなら、新たなAPI呼び出しは必要ありません。