Redditをどう連携するのが正しいかは、プロダクトが実際に何をするかによって変わります。コミュニティ内にインストールするモデレーションボット、非商用のOAuthクライアント、学術研究、商用のソーシャルリスニング製品では、アクセス方法も負う責任も同じではありません。
このガイドでは、現在のReddit公式の選択肢を説明し、アプリケーションがマネージド型の読み取り専用データエンドポイントを必要とする場合に、SocQで公開されている投稿、コメント、サブレディットのフィード、サブレディットのメタデータ、検索結果を取得する方法を紹介します。
結論: Reddit上で動作するアプリにはReddit公式のDeveloper Platformを使い、ユースケースがポリシーに合うなら公式のData APIに申請してください。ほかのソーシャルプラットフォームとあわせて、1つのAPIキーで正規化された公開Redditレコードを使いたい場合は、SocQを使ってください。どちらの方法も、Redditの利用規約、削除済みコンテンツに関する要件、プライバシーの権利、モデル学習への制限を無視してよいという許可にはなりません。
アクセス要件とポリシーは2026年7月19日時点で確認したものです。Redditは承認ルールや制限を変更することがあるため、公開前にリンク先の公式ドキュメントをご確認ください。
どのReddit APIを使うべきか
Redditは現在、いくつかの異なる開発者向けインターフェースを案内しています。
| 製品 | 想定する用途 | 重要な境界 |
|---|---|---|
| Developer Platform(Devvit) | Reddit上で動作するゲーム、ユーティリティ、モデレーションアプリ | Redditの体験のために作られたアプリ |
| Data API | Redditデータの読み取りまたは変更に対する、承認されたプログラムからのアクセス | OAuth、審査、ポリシー、レート制限が適用される |
| Reddit for Researchers | 対象となる学術研究 | 公式の研究向けルート。申請が必要 |
| Ads API | キャンペーンとレポートを管理する広告主 | 広告のワークフロー向けで、一般的なコミュニティデータではない |
| Reddit Embeds | 個別のRedditコンテンツの表示 | 大量のデータアクセスではなく、表示のための機能 |
| マネージド型の公開データAPI | 安定したスキーマで公開レコードを必要とするプロダクトのワークフロー | プロバイダーの対応範囲と規約が引き続き適用される |
Redditの開発者向けアクセスの概要によると、Data APIは承認された開発者向けであり、学術研究にはReddit for Researchersを使う必要があります。商用利用にはRedditの許可と契約が必要です。
つまり、APIの判断はコードライブラリからではなく、ユースケースの分類から始めるべきです。
2026年のReddit公式Data APIの要件
無料のData APIを利用できる場合、Redditは現在、登録済みのOAuthトークンと、内容が分かるUser-Agentを必須としています。認証のないトラフィックは、標準の利用枠が与えられずにブロックされることがあります。
Reddit Data API公式Wikiには、OAuthクライアントIDあたり1分間に100クエリという上限が、10分間の平均で適用されると記載されています。クライアントは次のヘッダーを読み取る必要があります。
X-Ratelimit-UsedX-Ratelimit-RemainingX-Ratelimit-Reset
100 QPMを、すべての商用ティアに共通の上限と考えないでください。これは、無料アクセスの対象となるユーザー向けに公開されている上限です。Redditは、有料製品、広告収益型の製品、サブスクリプションサービス、料金を取って販売されるサービスを含む商用利用には、事前の許可が必要だとしています。より広い範囲のアクセスや有料アクセスは、公開されたセルフサービスの料金表ではなく、別途扱われます。
Redditは削除への対応も求めています。現在のガイダンスでは、Redditから削除されたコンテンツを保存している場合は自社システムからも削除し、削除されたアカウントに紐づく投稿者を特定できる情報も取り除く必要があるとされています。ドキュメントでは、コンプライアンスを確保しやすくするため、保存しているユーザーデータとコンテンツを48時間以内に定期的に削除することを推奨しています。
公式APIの認証例
インストール型またはスクリプト型のアプリケーションは通常、クライアント認証情報とユーザーの認可をOAuthトークンと交換し、そのトークンをoauth.reddit.comに送信します。
簡略化したリクエストの形は次のとおりです。
curl "https://oauth.reddit.com/r/learnpython/new?limit=25" \
-H "Authorization: Bearer $REDDIT_ACCESS_TOKEN" \
-H "User-Agent: web:socq-guide:v1.0 (by /u/your_username)"
本番のクライアントでは、次のことが必要です。
- 正しいユースケースで登録し、承認を得る。
- 該当するOAuthグラントを実装する。
- 対応している場合は、期限が切れるトークンを更新する。
- 正確で一意なUser-Agentを送信する。
- レート制限のヘッダーを尊重し、上限に達する前に待機する。
- 削除とポリシーの変更を処理する。
Pythonの開発者は、リストオブジェクト、ページネーション、OAuthの詳細を扱うためにPRAWをよく使います。依存関係を減らしたい場合は、HTTPを直接使うのも適切ですが、ポリシー上の義務がなくなるわけではありません。
SocQでURLからRedditの投稿を取得する
SocQのReddit Posts APIは、公開されているRedditの投稿URLとredd.itの短縮リンクを受け付けます。正規化されたタイトル、本文、投稿者、コミュニティのコンテキスト、タイムスタンプ、公開メディアへの参照、表示されているエンゲージメントを返します。
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/learnpython/comments/POST_ID/POST_SLUG/"
]
}'
このリクエストは非同期タスクを作成します。返されたtask_idを保存し、ポーリングしてください。
curl "https://api.socq.ai/v1/tasks/$TASK_ID?limit=100" \
-H "Authorization: Bearer $SOCQ_API_KEY"
タスクが成功すると、レコードはdata.results.itemsに入ります。has_moreがtrueの間は、next_cursorを使って続きを取得してください。
投稿レコードは、ほかのSocQのリソースと同じ大枠の形をしています。
{
"id": "post_id",
"platform": "reddit",
"resource": "posts",
"type": "post",
"url": "https://www.reddit.com/r/learnpython/comments/post_id/example/",
"name": "Example post title",
"text": "Example post body",
"author": {
"username": "example_user",
"name": "example_user"
},
"metrics": {
"upvotes_count": 842,
"comments_count": 54,
"upvote_ratio": 0.96
},
"created_at": "2026-07-16T08:00:00Z",
"collected_at": "2026-07-19T08:00:00Z",
"extra": {
"tag": "Discussion",
"community_name": "learnpython"
}
}
表示されているスコアはスナップショットであり、恒久的な正解ではありません。Redditは投票数にゆらぎを加えることがあり、コンテンツは編集や削除が行われるため、後から収集すると結果が異なる場合があります。
Redditのコメントを取得する
既知の投稿URLの下にある公開ディスカッションが必要な場合は、Reddit Comments APIを使います。
curl -X POST "https://api.socq.ai/v1/reddit/comments" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"urls": [
"https://www.reddit.com/r/learnpython/comments/POST_ID/POST_SLUG/"
]
}'
正規化されたコメントレコードには、次の情報が含まれます。
- コメントのID、URL、テキスト。
- 取得できる場合は、公開されている投稿者のフィールド。
- 表示されているアップボート数と返信数。
- 元の投稿とコミュニティへの参照。
- 取得できる場合は、親コメントのID。
- 投稿日時と収集日時のタイムスタンプ。
現在のSocQのエンドポイントは、results_limitの入力を受け付けません。表示されているすべてのブランチ、折りたたまれた返信、削除されたコメント、モデレーター限定の項目、動的にランク付けされた結果がすべて返されるとは考えないでください。スレッド全体の再構築が必須の要件である場合は、プロバイダーを選ぶ前に、代表的な深いスレッドと大きなスレッドでテストしてください。
サブレディットの新着・トップ・人気の投稿を取得する
コミュニティのモニタリングには、Reddit Subreddit Posts APIを使います。公開されているサブレディットのURLを1つ以上受け付けます。sort_byはnew、top、hotに対応し、results_limitは送信したサブレディットごとに1〜2,000を指定できます。
curl -X POST "https://api.socq.ai/v1/reddit/subreddit-posts" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"urls": [
"https://www.reddit.com/r/learnpython/",
"https://www.reddit.com/r/webdev/"
],
"sort_by": "new",
"results_limit": 250
}'
並び順は目的に合わせて選んでください。
| ソート | 向いている用途 | 制限 |
|---|---|---|
new | 増分モニタリングとアラート | シグナルの弱い投稿が多く含まれる |
hot | 現在コミュニティで注目されている話題 | ランキングが常に変動する |
top | エンゲージメントの高い投稿の探索 | 古い投稿や、すでに人気のコンテンツが過大に表れることがある |
モニタリングでは、newをスケジュールで収集し、投稿IDで重複を排除してください。hotやtopは、時系列のフィードを上書きするのではなく、別の探索用ビューとして使います。
キーワードでRedditの投稿を検索する
Reddit Search APIは、クエリ、1〜2,000件の結果上限、公開期間を受け付けます。
curl -X POST "https://api.socq.ai/v1/reddit/search" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"query": "\"social listening\" API",
"results_limit": 500,
"published_within": "month"
}'
指定できる期間は、hour、day、week、month、year、allです。
検索結果はランク付けされた探索結果であり、網羅性が保証されたアーカイブではありません。クエリの構文、ランキング、取得可能性、インデックスのいずれもが、カバー範囲に影響します。1つの広いクエリで会話全体を表せると期待せず、絞り込んだ複数のクエリを実行してください。
たとえばブランドモニタリングでは、クエリのセットを使います。
"Acme Cloud"
acmecloud
"Acme API"
"Acme Cloud" pricing
"Acme Cloud" alternative
アナリストが各レコードがデータセットに入った理由を説明できるように、クエリは探索のコンテキストとして保存してください。
サブレディットの詳細とサブレディット内の検索
コミュニティそのものを対象にしたエンドポイントがもう2つあります。Reddit Subreddit Details APIは、公開されているサブレディットのURLを受け付け、購読者数、週間アクティブユーザー数、ルール、コミュニティのアセットなどのメタデータを返します。モニタリングを始める前に、そのコミュニティが追う価値があるかを手軽に見極められます。
Reddit Subreddit Search APIは、特定の1つのサブレディット内の公開ディスカッションと投稿を、クエリ、期間、ソート順で検索します。ブランド名が関係するのはごく一部のコミュニティだけで、Reddit全体の検索では埋もれてしまう場合に使ってください。正確な入力フィールドは、各エンドポイントのページで確認してください。
信頼性の高いRedditモニタリングパイプラインを構築する
耐久性のあるワークフローでは、収集、保存、分析を分離します。
Query/subreddit registry
↓
Scheduled SocQ submissions
↓
Task polling with backoff
↓
Normalize + deduplicate by Reddit ID
↓
Deletion/retention controls
↓
Classification, alerts and reporting
推奨する実装ルールは次のとおりです。
- 安定したIDを使う。 URLやスラッグは変わることがあります。重複排除のキーには、RedditのIDのほうが適しています。
- 取得元のコンテキストを保持する。 サブレディット、クエリ、ソート、収集日時を保存します。
- スナップショットとエンティティを分ける。 メトリクスは変化しますが、投稿IDは変わりません。
- 個々のレコードではなくタスクをリトライする。 指数バックオフにより、重複した送信を避けられます。
- 欠落と削除の状態を記録する。 存在しないことを、空だが有効な投稿に変換しないでください。
- 個人データを最小限にする。 ほとんどの分析では、投稿者単位の長期的な履歴は不要です。
- 消去の経路を用意する。 データモデルは、コンテンツと投稿者への参照を削除できるようにしてください。
Reddit公式APIとSocQの比較
| 要件 | Reddit公式API | SocQ |
|---|---|---|
| Reddit上のアプリやモデレーションツールの構築 | 最適 | 非対応 |
| Redditでの読み取り・書き込み操作 | 承認とスコープの範囲で対応 | 読み取り専用の公開データ |
| OAuthとRedditアプリの登録 | 必須 | SocQのAPIキー |
| 公開投稿・コメントの正規化 | Reddit固有のオブジェクト | SocQの共通スキーマ |
| マルチプラットフォームのソーシャルプロダクト | 連携がそれぞれ別 | 27のプラットフォームで同じタスクモデル |
| 公開されている無料のレート制限 | 対象のOAuthクライアントで100 QPM | SocQカタログのエンドポイント料金 |
| 商用利用の許可 | Redditの許可/契約を取得する必要がある | プロバイダー経由のアクセスでも、Redditのルールは免除されない |
| 学術研究 | Reddit for Researchersが必須 | ポリシー回避の手段として使わないこと |
プロダクトがユーザー認可に基づく操作、モデレーション、投稿、投票、メッセージ送信、あるいはRedditに深く依存した連携を行う場合は、公式のルートを選んでください。書き込みアクセスよりも、正規化されたマルチプラットフォームのレコードとマネージド型の抽出が重要で、公開データの収集がサポート対象に含まれる場合は、SocQを選んでください。
ワークロードとコストを見積もる
プロバイダーを「リクエスト数」だけで比較しないでください。1回のリクエストで、投稿1件が返ることもあれば、コメントの1ページ分、あるいは数百件のサブレディットの結果が返ることもあります。
次の式で見積もります。
monthly records =
direct post lookups
+ comments returned
+ subreddit posts returned
+ search results returned
monthly workload =
schedules × inputs per run × average records per input
そのうえで、次の点を考慮してください。
- 空の結果、または取得できない結果。
- 更新の頻度。
- 検索結果の重複と、その排除。
- 深いコメントスレッド。
- ストレージと削除処理。
- 同時実行数とレイテンシの要件。
- 成功した結果のみが課金対象かどうか。
年間の支出を見積もる前に、小規模から大規模までのコミュニティで、代表的なパイロットを実施してください。
責任ある利用とデータ保持
公開されているからといって、あらゆる用途が許可されているわけではありません。Redditの現行ポリシーは、承認なしの商用アクセスを制限し、明示的な同意なしにRedditのコンテンツをモデル学習に使うことを禁止しています。削除に関する義務も課されています。
規模を拡大する前に、次の対策を整えてください。
- 宣言した目的に必要なフィールドだけを収集する。
- センシティブな人物のプロファイリングや、個人への嫌がらせを避ける。
- サブレディットやアカウントの制限を回避するためにAPIを使わない。
- コンテンツを表示する場合は、出典の表示を維持する。
- 生のコンテンツの保持期間を短く設定する。
- 利用できなくなったコンテンツは、再確認または削除する。
- APIキーを保護し、エクスポートへのアクセスを監査する。
- 商用、研究、リスクの高い用途では、法務のレビューを受ける。
SocQは技術的なアクセス層であり、知的財産、プライバシー、研究、商用に関する権利を付与するものではありません。
Reddit APIのよくある質問(FAQ)
Reddit APIは無料ですか?
Redditは、ユースケースに応じて無料アクセスと有料アクセスを提供しています。無料のData APIの対象となるクライアントには、現在、OAuthクライアントIDあたり100 QPMという公開された上限があります。商用利用にはRedditの許可が必要で、契約と料金が必要になる場合があります。
OAuthなしでReddit APIを使えますか?
認証なしのアクセスを前提に設計しないでください。Redditの現行ドキュメントでは、登録済みのOAuthトークンが必要で、OAuthやログインの認証情報がないトラフィックはブロックされると記載されています。
AIの学習のためにRedditをスクレイピングできますか?
Redditは、明示的な同意なしに、そのコンテンツをモデル学習の入力として使うことはできないとしています。サードパーティのAPIを使っても、この制限はなくなりません。
SocQはRedditのコメントに対応していますか?
はい。SocQには、6つのRedditエンドポイントがあります。個別の投稿、投稿URLからのコメント、サブレディットの投稿探索、サブレディットの詳細、Reddit全体を対象にしたキーワード検索、単一のサブレディット内の検索です。
SocQでRedditに投稿、投票、モデレーションはできますか?
いいえ。SocQのRedditエンドポイントは、対応している公開レコードを収集します。認可された書き込み操作とモデレーションには、Reddit公式の開発者向け製品を使ってください。
Redditの検索結果は網羅的ですか?
いいえ。検索は、ランク付けされた探索として扱ってください。結果はクエリ、期間、インデックス、取得可能性に依存し、完全な過去のアーカイブではありません。
Redditのユーザーがコンテンツを削除した場合はどうなりますか?
システムは、そのコンテンツと、関連する投稿者を特定できる情報を削除できる必要があります。Reddit公式のガイダンスでは、コンプライアンスを簡単にするため、保存しているユーザーデータとコンテンツを48時間以内に定期的に削除することを推奨しています。