reddit/
posts

対応する投稿URLから公開Reddit投稿を取得し、タイトル、本文、投稿者、コミュニティ情報、メディア、タイムスタンプ、表示中のエンゲージメントを正規化されたレコードで返します。

Reddit Posts API

投稿URLで指定
コミュニティ情報
エンゲージメントのスナップショット
結果1件あたり0.5クレジット
準備完了
準備完了

パラメータを入力してリクエストを送信してください。タスクのステータスと正規化された結果がここに表示されます。

README

SocQ 編集 · 更新

Reddit Posts

Reddit投稿はコミュニティへの投稿で、公開ページにはタイトル、本文、投稿者、フレア、メディア、投稿日時、表示中の投票数やコメント数が含まれることがあります。これらのフィールドをサブレディットと取得日時に結びつけることで、個々の投稿をソースの確認、コンテンツ分析、タイムスタンプ付きの比較に活用できます。

Reddit Posts API の主な機能

  • 投稿の直接取得対応するRedditのディスカッションURLまたは redd.it 短縮リンクから、その公開投稿の正規化レコードを取得します。サブレディットのトップページや無関係なパスは拒否されます。
  • 投稿内容と投稿者情報投稿ID、公開URL、タイトル、本文、取得可能な投稿者IDを返し、各アイテムをソースまでたどれるようにします。
  • サブレディットと分類の情報ソースが提供している場合、フレアに加え、コミュニティ名、URL、表示中のメンバー数を extra に含めて返します。
  • メディア・エンゲージメント・取得日時メディアの参照、created_at、collected_at、upvotes_count、comments_count、upvote_ratio をまとめて、タイムスタンプ付きのスナップショットとして保持します。

Reddit Posts API のパラメータ

パラメータ必須説明
urls必須必須。対応するRedditホスト上の /r/{subreddit}/comments/{post_id} パス、または redd.it 短縮リンクを使った公開Reddit投稿URLのリストです。

Reddit Posts API の使い方

必要な公開投稿を指定して送信し、非同期タスクを追跡して、正規化されたレコードをカーソルページネーションで読み取ります。

  1. 対応する comments パスまたは redd.it 短縮リンクを使った公開Reddit投稿URLを1件以上用意します。
  2. リンクを urls として /v1/reddit/posts に送信し、返された task_id を保存します。
  3. タスクが成功するか失敗を返すまで /v1/tasks/{task_id} をポーリングします。
  4. data.results.items を読み取り、has_more が true の間は返された next_cursor を指定して続きを取得します。
curl -X POST "https://api.socq.ai/v1/reddit/posts" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://www.reddit.com/r/example/comments/post_id/example_post/"]}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is true

Reddit Posts API の主なユースケース

  • ソースに基づく投稿レビュー: 投稿ID、URL、タイトル、本文、投稿者のフィールドを保持し、分析に含めた公開投稿をレビュー担当者があとから正確に確認できるようにします。
  • コミュニティ横断のトピック比較: タイトルと本文を community_name と tag でグループ化し、特定のトピックが選んだサブレディット間でどのように語られているかを分析します。
  • タイムスタンプ付きのエンゲージメント追跡: upvotes_count、comments_count、upvote_ratio を collected_at とあわせて保存し、値を固定のものとみなさずに繰り返し取得したスナップショットを比較します。

Reddit Posts API 活用のヒント

  • 短縮リンクと完全なディスカッションURLが同じ投稿を指すことがあるため、まとめて送信する前に redd.it リンクを解決し、投稿IDで重複を除外してください。
  • このエンドポイントは投稿URLがすでにわかっている場合に使用してください。サブレディットのトップページ、検索クエリ、並び替えの指定、results_limit は受け付けません。
  • 公開ソースで公開されていない場合に備え、投稿者、メディア、タグ、コミュニティ情報、タイムスタンプ、指標が null になることを許容してください。
  • あとのスナップショットと観測日時を上書きせずに比較できるよう、表示中のエンゲージメント指標と並べて collected_at を保存してください。

Reddit Posts API 以外に別の種類の公開Redditデータが必要な場合は、これらのAPIをご利用ください。

  • Reddit Comments API — 対応する投稿URLから、公開コメントのテキスト、投稿者、投稿と親コメントの参照、コミュニティ情報、タイムスタンプ、表示中のエンゲージメントを取得します。
  • Reddit Subreddit Posts API — サブレディットのURLから公開投稿を探します。new・top・hotの並び順とサブレディットごとの取得上限を指定でき、正規化されたコミュニティ情報とエンゲージメント情報を返します。
  • Reddit Search API — テキストクエリと公開期間でRedditの公開投稿を検索し、正規化されたコンテンツ、投稿者、コミュニティ情報、タイムスタンプ、メディア、表示中のエンゲージメントを返します。
  • Reddit Subreddit Details API
  • Reddit User Posts API — 1つのユーザー名から、Redditユーザーの投稿履歴を new・top・hot の順で、タイトルと本文、スコア、コメント数、メディアとともに取得します。
  • Reddit Popular Feed API — r/popular の投稿を hot・best・new・rising・top の順で、タイトルと本文、投稿者、スコア、コメント数、メディアとともに取得します。

他のプラットフォームを見る

Redditのデータを、対応する他のソーシャルプラットフォームの公開データと組み合わせられます。

Reddit Posts API — よくある質問

Reddit Posts APIは、対応する公開Reddit投稿URLから、投稿内容、投稿者とサブレディットの情報、メディア、タイムスタンプ、表示中のエンゲージメント指標を含む正規化レコードを取得するAPIです。

reddit.com、www.reddit.com、old.reddit.com、new.reddit.com 上で、パスが /r/{subreddit}/comments/{post_id} で始まる http または https のURLを送信してください。redd.it と www.redd.it の短縮リンクも使用できます。

できません。Reddit Posts APIは urls に指定した特定の投稿URLを取得するもので、投稿を探すためのサブレディットのトップページ、キーワード、並び替えの指定は受け付けません。

できません。各入力は件数を絞り込む投稿フィードではなく特定の投稿を指すため、このエンドポイントは urls のみを受け付けます。

含まれません。各投稿レコードには表示中の comments_count が含まれる場合がありますが、コメント本文やコメント投稿者は含まれません。

公開ソースで利用可能な値が公開されていない場合、投稿者の詳細、メディア、フレア、コミュニティ情報、投稿日時、エンゲージメントの値が null または空になることがあります。

返された投稿レコード1件につき0.5 SocQクレジットです。結果が空の場合は結果の料金はかかりません。