API一覧に戻る
Redditの公開データ

Reddit公開データAPI

既知のURLから公開Redditの投稿とコメントを取得したり、サブレディットの新着・トップ・人気の投稿を閲覧したり、キーワードと公開期間で議論を検索したりできます。

利用できるReddit API

既知の投稿1件にはPosts、その公開返信にはComments、コミュニティのフィードにはSubreddit Posts、キーワードによる検索にはSearchを使用します。

取得できるRedditデータ

SocQは、コミュニティ、返信、検索、エンゲージメント、取得時点のコンテキストを含む正規化された公開Redditコンテンツを返し、議論の分析に活用できるようにします。

投稿と表示中のエンゲージメント

タイトル、本文、投稿者、フレア、コミュニティのコンテキスト、メディア、取得元URL、collected_at 時点の表示中の指標を取得します。

コメントと返信の関係

公開コメントの本文、投稿者、元の投稿と親コメントの参照、タイムスタンプ、賛成票数、返信数を取得します。

サブレディットの閲覧

/r/{subreddit} のURLから新着・トップ・人気の投稿を閲覧でき、コミュニティごとに個別の取得件数上限を設定できます。

キーワード検索

テキストクエリと公開期間で公開投稿を検索し、一致した投稿と検索のコンテキストをまとめて保持します。

SocQ vs Reddit Data API

SocQは公開Redditデータの取得ワークフローを提供します。RedditのData APIは、Redditデータにアクセスしたり変更したりする承認済みアプリ向けの公式インターフェースです。

機能SocQReddit Data API
主な用途公開投稿、コメント、サブレディットの一覧、検索結果の取得承認済みのRedditアプリ、連携、モデレーションツールの構築
認証SocQのAPIキーのみ。RedditユーザーのOAuthは不要Redditの承認、OAuth認証情報、申告済みのアプリ情報
入力の起点公開投稿やサブレディットのURL、またはテキストクエリRedditのエンドポイント、fullname、一覧のパラメータ、OAuthスコープ
投稿・投票・モデレーション非対応必要なユーザースコープを持つ承認済みのユースケースで対応
レスポンス形式正規化されたSocQレコードReddit独自のオブジェクトと一覧

Reddit APIの仕組み

直接取得、サブレディットの閲覧、キーワード検索のいずれも、共通の非同期タスクとページネーション付きの結果取得ワークフローを使用します。

  1. 1. 入力を送信

    投稿URL、サブレディットURL、または検索クエリを対応するAPIに送信し、返された task_id を保存します。

  2. 2. タスクを追跡

    処理が完了するまで /v1/tasks/{task_id} をポーリングします。

  3. 3. 結果を取得

    data.results.items を読み取り、has_more が true の間は next_cursor を使用します。

公開Redditの議論を検索

SocQのAPIキーで認証し、キーワードと公開期間を送信します。ほかのReddit APIも同じタスクフローで利用できます。

curl -X POST "https://api.socq.ai/v1/reddit/search" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"machine learning","results_limit":100,"published_within":"month"}'

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

Reddit APIの主なユースケース

コミュニティのモニタリング

選んだサブレディットから新着・トップ・人気の投稿を取得し、コミュニティ間で表示中のアクティビティを比較します。

議論と反応の分析

選んだ議論について、投稿内容、コメント本文、返信の関係、投稿者、取得時点のエンゲージメントを分析します。

トピック・市場調査

キーワードと期間を指定して検索し、商品、ブランド、競合、トレンドに関する公開の議論を見つけます。

調査用アーカイブとデータセット

公開投稿、コメント、取得元リンク、コミュニティのコンテキスト、タイムスタンプ、表示中の指標を保存し、再現可能な分析に活用します。

制限事項と公開データポリシー

Redditの結果は、特定時点の公開レコードです。これらのAPIは、非公開コミュニティ、削除済みコンテンツ、アカウントデータ、モデレーション機能にはアクセスしません。

  • PostsとCommentsは、対応する投稿URLまたはredd.itのリンクを受け付けます。Subreddit Postsには、正確な /r/{subreddit} のパスが必要です。
  • Subreddit Postsは新着・トップ・人気の並び順に対応し、results_limit はサブレディットURLごとに個別に適用されます。
  • Searchは、1つのクエリ、1〜2,000の results_limit、および hour、day、week、month、year、all のいずれかの公開期間を受け付けます。サブレディットや並び順のフィルターはありません。
  • PostsとCommentsは別々のリソースです。投稿には comments_count が含まれますが、個々のコメントのレコードは含まれません。
  • Commentsは表示中の公開コメントを返しますが、返信ツリー全体や過去の議論のすべてを取得できることは保証しません。
  • 表示中の指標は、collected_at 時点のスナップショットです。公開ソースが提供しない任意のフィールドは、null または空になる場合があります。

Reddit APIに関するよくある質問

Reddit APIとは何ですか?

Reddit APIは、既知の公開投稿とコメントの取得、サブレディットの投稿の閲覧、キーワードと公開期間による公開の議論の検索ができるSocQのエンドポイント群です。

どのRedditリンクに対応していますか?

PostsとCommentsは、対応する /r/{subreddit}/comments/{post_id} のパスまたはredd.itのリンクを受け付けます。Subreddit Postsは、正確な /r/{subreddit} のパスを受け付けます。

どのReddit APIを選べばよいですか?

既知の投稿にはPosts、その公開返信にはComments、コミュニティの一覧にはSubreddit Posts、キーワードによる検索にはSearchを使用してください。

サブレディットの閲覧とReddit検索の違いは何ですか?

Subreddit Postsは、正確な /r/{subreddit} のURLから新着・トップ・人気の投稿を閲覧します。Searchは、1つのテキストクエリと公開期間から公開投稿を検索します。

Redditのコメントやエンゲージメント指標は完全、またはリアルタイムですか?

いいえ。Commentsは取得時点で返された表示中の公開返信を反映し、エンゲージメントの値は特定時点のスナップショットです。完全な履歴やリアルタイムのフィードではありません。

Redditデータ取得の料金はどのように計算されますか?

PostsまたはSubreddit Postsの結果は1件あたり0.5クレジット、コメントは1件あたり0.3クレジット、Searchの結果は1件あたり0.6クレジットです。結果が空の場合、結果に対する料金は発生しません。

さまざまなプラットフォームの公開プロフィール、コンテンツ、エンゲージメントデータを1つのワークフローに集約し、ブランド、クリエイター、トピックの追跡やクロスプラットフォームのモニタリング・分析をより効率的に行えます。

Pinterest API

公開Pinterestプロフィールのデータ取得、既知のピンの解決、指定したプロフィールのピンの取得、キーワード検索ができ、クリエイター、コンテンツ、ビジュアルトレンドの調査に活用できます。

Threads API

公開Threadsプロフィールの取得、既知の投稿の解決、指定したプロフィールの投稿の取得ができます。アカウント情報、コンテンツ、メディア、エンゲージメント、タイムスタンプのフィールドは正規化されています。

Bluesky API

公開Blueskyプロフィールの取得、既知の投稿URLの解決、アカウントの投稿の1ページ分の取得ができます。アカウント情報、コンテンツ、メディア、タイムスタンプ、表示中のエンゲージメントのフィールドは正規化されています。

Snapchat API

既知の公開Snapchat Spotlightを、取得可能なクリエイター、キャプション、メディア、音源、タイムスタンプ、再生時間、エンゲージメントのフィールドを含む正規化レコードとして取得できます。

Twitch API

既知の公開Twitchユーザー名から正規化されたプロフィールや公開動画の一覧を取得したり、クリップ1件をダウンロード可能な動画とともに取得したりでき、クリエイター調査、カタログの情報補完、比較、スナップショットのモニタリングに活用できます。

Rednote API

公開プロフィールとノートの取得、ノートやユーザーの検索、コメントとネストされた返信の取得、ホームのおすすめ1ページ分の取得ができます。