SocQはこれまでも、Redditの投稿、コメント、サブレディットの一覧、検索に対応していました。2026-11-17には、それとは別の問いに答える7つのエンドポイントを追加しました。このRedditユーザーは誰で、何を投稿し、何を発言し、どこで活動しているのか、そしてReddit全体で何がトレンドになっていて、各サブレディットでは何が許可されているのか、という問いです。
このガイドでは、新しい各エンドポイントが返すデータ、リクエストの形、料金、使いどころを説明します。Reddit公式のAPI、OAuth、以前に公開されたエンドポイントについては、Reddit APIガイドとReddit スクレイパーAPIの比較をご覧ください。
結論:
Authorization: Bearer $SOCQ_API_KEYを付けて、ユーザー名、サブレディットのURL、または入力なしで、7つのPOST /v1/reddit/...エンドポイントのいずれかに送信します。statusがsucceededになるまでGET /v1/tasks/{task_id}をポーリングし、data.results.itemsを読み取ります。5つのエンドポイントは結果1件ごとの課金(0.3または0.5クレジット)で、Active SubredditsとTrending Searchesは1回の呼び出しにつき0.5クレジットです。1クレジットは$0.005です。
新しく追加された7つのRedditエンドポイント
| エンドポイント | 返すデータ | 料金 |
|---|---|---|
| User Profile | カルマ(投稿とコメント)、投稿数とコメント数、アカウント歴、自己紹介、アバター、トロフィー、認証済みと社員のフラグ | アカウント1件あたり0.5クレジット($0.0025) |
| User Posts | new、top、hotで並べたユーザーの投稿。全文、スコア、コメント、メディアを含む | 投稿1件あたり0.5クレジット($0.0025) |
| User Comments | ユーザーのコメント。スコア、日時、リンク、コメント先の投稿を含む | コメント1件あたり0.3クレジット($0.0015) |
| User Active Subreddits | ユーザーが活動しているサブレディット。メンバー数と説明文を含む | 1回の呼び出しにつき0.5クレジット($0.0025) |
| Popular Feed | best、hot、new、top、risingで並べたr/popularの投稿 | 投稿1件あたり0.5クレジット($0.0025) |
| Trending Searches | 当日のRedditのトレンド検索(順位付き) | 1回の呼び出しにつき0.5クレジット($0.0025) |
| Subreddit Rules | 番号付きのルール。短いタイトルと全文を含む | サブレディット1件あたり0.5クレジット($0.0025) |
Redditユーザーを調べる
Reddit User Profile
Reddit User Profile APIは、アカウントごとに1行を返します。内容は、投稿カルマとコメントカルマに分けた合計カルマ、そのアカウントの投稿数とコメント数、作成日時、プロフィールの自己紹介とアバター、トロフィー数、認証済みアカウントとReddit社員を示すフラグです。アウトリーチの前にクリエイターを見極めたり、スレッドの投稿者たちがどれだけ実績のあるアカウントかを判断したりするのに使えます。
curl -X POST "https://api.socq.ai/v1/reddit/user-profile" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"usernames": ["spez", "GovSchwarzenegger"]
}'
ユーザー名は最大100件まで送信でき、u/の接頭辞は付けても付けなくてもかまいません。詳しくはUser Profileのドキュメントをご覧ください。
Reddit User Posts
Reddit User Posts APIは、ユーザーの投稿履歴を取得します。テキスト投稿の全文、投稿リンク、スコア、コメント数、公開日時、画像や動画が含まれます。その人がいま何を共有しているかを追うにはnewで、どの投稿が最も反響を得たかを見るにはtopで並べ替えます。
curl -X POST "https://api.socq.ai/v1/reddit/user-posts" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"username": "spez",
"sort_by": "new",
"results_limit": 25
}'
sort_byはnew(デフォルト)、top、hotのいずれかです。results_limitのデフォルトは25で、1〜1,000を指定できます。likes_countには投稿のスコアが入ります。詳しくはUser Postsのドキュメントをご覧ください。
Reddit User Comments
コメント履歴は、本人の投稿よりも、その人が何に詳しく何に関心を持っているかをよく表します。Reddit User Comments APIは、各コメントをスコア、日時、コメントへのリンク、コメント先の投稿のpost_idとともに返します。専門家や見込み顧客を絞り込んだり、あるアカウントが自社製品についてどう語っているかを追跡したりするのに使えます。
curl -X POST "https://api.socq.ai/v1/reddit/user-comments" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"username": "spez",
"sort_by": "top",
"results_limit": 100
}'
results_limitのデフォルトは100で、1〜1,000を指定できます。textには最大300文字のプレビューが入り、urlからコメント全文を開けます。詳しくはUser Commentsのドキュメントをご覧ください。
Reddit User Active Subreddits
Reddit User Active Subreddits APIは、ユーザーが最近投稿またはコメントしたコミュニティを、それぞれのメンバー数と説明文とともに一覧で返します。その人の関心の範囲を把握でき、自社のオーディエンスが集まるニッチなコミュニティを見つける手がかりになります。
curl -X POST "https://api.socq.ai/v1/reddit/user-active-subreddits" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"username": "GovSchwarzenegger"
}'
1回のリクエストは0.5クレジットで、そのアカウントの公開されているアクティブ一覧にあるすべてのコミュニティを返します。詳しくはActive Subredditsのドキュメントをご覧ください。
Redditで何がトレンドかを把握する
Reddit Popular Feed
Reddit Popular Feed APIは、Redditでの表示と同じ形でr/popularを読み取ります。すべてのコミュニティで伸びている投稿を、タイトルと本文、リンク、投稿者、スコア、コメント数、メディアとともに返します。sort_byをtopに切り替えてpublished_withinを指定すると、1日や1週間のあいだに大きく注目された投稿を確認できます。
curl -X POST "https://api.socq.ai/v1/reddit/popular-feed" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"sort_by": "hot",
"results_limit": 25
}'
すべてのフィールドは省略可能です。sort_byはbest、hot(デフォルト)、new、top、risingのいずれかです。published_withinはtopのときに適用され、hourからallまでを指定できます。results_limitのデフォルトは25で、1〜500を指定できます。詳しくはPopular Feedのドキュメントをご覧ください。
Reddit Trending Searches
Reddit Trending Searches APIは、当日のトレンド検索をRedditの表示順で返します。多くの場合、進行中のニュース、製品のローンチ、話題の出来事などが並びます。1日に数回ポーリングしてトレンドのダッシュボードを作り、気になるテーマはReddit Searchで掘り下げられます。
curl -X POST "https://api.socq.ai/v1/reddit/trending-searches" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{}'
入力は不要です。呼び出すたびにその時点の一覧(通常は6件の検索)を、1位からの順位付きで返します。詳しくはTrending Searchesのドキュメントをご覧ください。
投稿前にサブレディットのルールを確認する
Reddit Subreddit Rules APIは、サブレディットごとに1行を返し、番号付きのルールを順番どおりに含めます。各ルールには、モデレーターが報告メニューに表示する短いタイトルと、ルールの全文が付きます。ブランドはローンチ投稿の前に何が許可されているかを確認するのに使い、多数のアカウントを運用するチームはコミュニティごとのルールブックを管理するのに使えます。
curl -X POST "https://api.socq.ai/v1/reddit/subreddit-rules" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"urls": ["https://www.reddit.com/r/AskReddit/"]
}'
詳しくはSubreddit Rulesのドキュメントをご覧ください。
認証と非同期タスクの流れ
すべてのリクエストには、APIキーとJSONのContent-Typeを付けます。
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
送信リクエストごとに、バックグラウンドタスクが開始されます(submit -> task_id -> queued -> running -> succeeded、またはfailed)。送信時のレスポンスにはdata.task_idとdata.statusが含まれます。タスクをポーリングします。
curl "https://api.socq.ai/v1/tasks/$TASK_ID?limit=50" \
-H "Authorization: Bearer $SOCQ_API_KEY"
タスクがqueued、running、failedの間、レスポンスにはタスクのメタデータのみが含まれます。failedの場合はerror_messageを確認してください。succeededになると、レスポンスのdata.results.itemsに正規化されたレコードの最初のページが含まれます。limitのデフォルトは50で、最大500まで指定できます。has_moreがtrueの場合は、results.next_cursorをcursorとして渡します。fieldsにはカンマ区切りで最大50個のフィールドまたはドットパスを指定できます。
クライアント側でタイムアウトしてもタスクはキャンセルされません。重複したタスクに支払うのではなく、同じtask_idで照会を再開してください。送信ボディにcallback_urlを追加すると、タスクの完了時にタスクの概要をPOSTで1回受け取ることもできます。
典型的なジョブの料金
- スレッドの投稿者100人のプロフィールを取得する:100 × 0.5 = 50クレジット、$0.25。
- 1人のユーザーをひととおり調べる(投稿25件、コメント100件、アクティブなサブレディット):12.5 + 30 + 0.5 = 43クレジット、$0.215。
- トレンド検索を1日4回、30日間取得する:120 × 0.5 = 60クレジット、$0.30。
よくある質問(FAQ)
多数のRedditユーザーをまとめて調べられますか?
User Profileは1回のリクエストで最大100件のユーザー名を受け付けます。User Posts、User Comments、Active Subredditsは1件のusernameのみを受け付けるため、ユーザーごとに1つのタスクを送信してください。
User Commentsはコメントの全文を返しますか?
textには最大300文字のプレビューが入ります。urlフィールドからコメント全文を開くことができ、post_idでコメント先の投稿を特定できます。
Popular FeedとSubreddit Postsの違いは何ですか?
Popular Feedはr/popularを読み取るもので、すべてのコミュニティで伸びている投稿が混在しています。1つのコミュニティを読み取るには、Subreddit Postsを使ってください。
投稿がないユーザーにも料金がかかりますか?
結果ごとに課金されるエンドポイントには基本料金がないため、結果が空なら料金はかかりません。Active SubredditsとTrending Searchesは、1回の呼び出しにつき一律0.5クレジットです。
Redditのデータプロバイダーはどこで比較できますか?
Reddit APIの代替サービスをご覧ください。SocQのすべてのRedditエンドポイントはRedditプラットフォームのページで、最新の料金は料金ページでご確認いただけます。