Reddit公開データAPI
既知のURLから公開Redditの投稿とコメントを取得したり、サブレディットの新着・トップ・人気の投稿を閲覧したり、キーワードと公開期間で議論を検索したりできます。
利用できるReddit API
既知の投稿1件にはPosts、その公開返信にはComments、コミュニティのフィードにはSubreddit Posts、キーワードによる検索にはSearchを使用します。

reddit/posts
投稿結果1件あたり0.5クレジット

reddit/comments
コメント結果1件あたり0.3クレジット

reddit/subreddit-posts
投稿結果1件あたり0.5クレジット

reddit/search
検索結果1件あたり0.6クレジット

reddit/subreddit-details
プロフィール結果1件あたり0.5クレジット

reddit/subreddit-search
検索結果1件あたり0.6クレジット

reddit/user-profile
プロフィール結果1件あたり0.5クレジット

reddit/user-posts
投稿結果1件あたり0.5クレジット

reddit/user-comments
コメント結果1件あたり0.3クレジット

reddit/user-active-subreddits
プロフィール1リクエストあたり0.5クレジット

reddit/popular-feed
投稿結果1件あたり0.5クレジット

reddit/trending-searches
検索1リクエストあたり0.5クレジット

reddit/subreddit-rules
プロフィール結果1件あたり0.5クレジット

reddit/answers
検索結果1件あたり6クレジット
取得できるRedditデータ
SocQは、コミュニティ、返信、検索、エンゲージメント、取得時点のコンテキストを含む正規化された公開Redditコンテンツを返し、議論の分析に活用できるようにします。
投稿と表示中のエンゲージメント
タイトル、本文、投稿者、フレア、コミュニティのコンテキスト、メディア、取得元URL、collected_at 時点の表示中の指標を取得します。
コメントと返信の関係
公開コメントの本文、投稿者、元の投稿と親コメントの参照、タイムスタンプ、賛成票数、返信数を取得します。
サブレディットの閲覧
/r/{subreddit} のURLから新着・トップ・人気の投稿を閲覧でき、コミュニティごとに個別の取得件数上限を設定できます。
キーワード検索
テキストクエリと公開期間で公開投稿を検索し、一致した投稿と検索のコンテキストをまとめて保持します。
SocQ vs Reddit Data API
SocQは公開Redditデータの取得ワークフローを提供します。RedditのData APIは、Redditデータにアクセスしたり変更したりする承認済みアプリ向けの公式インターフェースです。
| 機能 | SocQ | Reddit Data API |
|---|---|---|
| 主な用途 | 公開投稿、コメント、サブレディットの一覧、検索結果の取得 | 承認済みのRedditアプリ、連携、モデレーションツールの構築 |
| 認証 | SocQのAPIキーのみ。RedditユーザーのOAuthは不要 | Redditの承認、OAuth認証情報、申告済みのアプリ情報 |
| 入力の起点 | 公開投稿やサブレディットのURL、またはテキストクエリ | Redditのエンドポイント、fullname、一覧のパラメータ、OAuthスコープ |
| 投稿・投票・モデレーション | 非対応 | 必要なユーザースコープを持つ承認済みのユースケースで対応 |
| レスポンス形式 | 正規化されたSocQレコード | Reddit独自のオブジェクトと一覧 |
Reddit APIの仕組み
直接取得、サブレディットの閲覧、キーワード検索のいずれも、共通の非同期タスクとページネーション付きの結果取得ワークフローを使用します。
1. 入力を送信
投稿URL、サブレディットURL、または検索クエリを対応するAPIに送信し、返された task_id を保存します。
2. タスクを追跡
処理が完了するまで /v1/tasks/{task_id} をポーリングします。
3. 結果を取得
data.results.items を読み取り、has_more が true の間は next_cursor を使用します。
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 trueReddit 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ページ分の取得ができます。