プラットフォームの稼働状況
- 24時間の稼働状況
- 100%
過去30日間
利用可能な機能
Redditの各アクションについて、内容、料金、過去24時間の稼働状況を掲載しています。アクションを開くと、パラメータ、レスポンスフィールド、コードサンプルを確認できます。
| 機能 | できること | 1,000リクエストあたり | 24時間の稼働状況 |
|---|---|---|---|
検索search | keywordで過去1か月のReddit投稿を検索し、サブレディット、投稿者、本文、いいね数、コメント数を取得します。sortで指定しない限り関連度順に並びます。コメント本文は検索対象外で、それより古い投稿の取得は保証されません。 | 1,000リクエストあたり$0.56 | 良好・稼働状況100% |
サブレディットの投稿subreddit_posts | サブレディット名(pythonなど)またはURLで、Redditコミュニティの投稿を閲覧します。投稿者、本文、いいね数、コメント数を取得でき、期間と並び順で絞り込めます。rで始まる名前の場合は、/r/を含む完全なURLを指定してください。非公開の投稿や削除された投稿は含まれません。 | 1,000リクエストあたり$0.56 | 良好・稼働状況100% |
投稿詳細post_detail | リンクからRedditの投稿を1件開きます。タイトル、本文、投稿者、サブレディット、いいね数、コメント数を取得できます。コメントは含まれません。コメントは同じurlでcommentsを使って取得してください。 | 1,000リクエストあたり$0.56 | 正常 |
コメントcomments | Redditの1件の投稿に付いたコメントを、最大5階層のネストされた返信とともに読み取ります。各コメントには本文、投稿者、スコア、日時が含まれます。対象はその投稿のみで、サイト全体のコメント検索ではありません。スレッドのすべての分岐を取得できるとは限りません。 | 1,000リクエストあたり$0.56 | 良好・稼働状況100% |
ユーザーの投稿user_posts | ユーザー名または/user/のURLで、Redditユーザーが投稿した内容を取得します。サブレディット、本文、いいね数、コメント数を取得でき、期間と並び順で絞り込めます。メッセージと非公開の投票は除外され、すべての投稿の取得は保証されません。uで始まるユーザー名の場合は、完全なURLを指定してください。 | 1,000リクエストあたり$0.56 | 正常 |
ユーザーのコメントuser_comments | ユーザー名、u/name、またはプロフィールURLで、Redditユーザー1人のコメント履歴を読み取ります。各コメントには本文、スコア、日時と、コメント先の投稿のタイトル、ID、リンクが含まれます。新着順(デフォルト)、トップ、人気、議論の多い順で並べ替えでき、1回の呼び出しで最大200件のコメントを取得できます。 | 1,000リクエストあたり$32.4 | 正常 |
ペインポイントpainpoint | 製品やトピックのkeywordについて、Redditで人々が何に不満を持っているかを調査します。最初の要約1件に、読み取った投稿とコメントの数、否定的・肯定的なコメント数、最も多く繰り返された不満と称賛の単語、関係するコミュニティがまとまり、続いて上位の投稿と、最も支持された否定的コメントの全文が返ります。不満と称賛は単語リストで判定するため、カウントは大まかな目安として扱ってください。limitで分析する投稿数(2〜15)を指定します。 | 1,000リクエストあたり$72 | 正常 |
トレンド投稿trending_posts | 入力なしで、Reddit全体で現在トレンドになっている投稿を読み取ります。各投稿には、タイトル、本文、サブレディット、投稿者、スコア、コメント数、投稿日時、および外部リンクまたは画像(ある場合)が含まれます。プロモーション投稿は除外されます。1ページあたり25件で、next_page_tokenで次のページに進めます。 | 1,000リクエストあたり$0.56 | 正常 |
機能を開くと、パラメータ、レスポンスフィールド、コードサンプル、トライアルを確認できます。
Redditの各アクションではどのような入力を指定できますか?
以下の各回答では、呼び出し可能なアクション1つとその実際の入力を対応付けています。パラメータの意味と指定可能な値はアクションごとに異なります。同じ名前でも、すべてのプラットフォームで同じ意味になるとは限りません。
公式情報源へのリンクは、横に記載したプラットフォーム用語を説明する目的でのみ掲載しています。プラットフォームによる認可や推奨を意味するものではありません。また、このページに記載がない限り、公式サイトの機能はEveryInfra APIには含まれません。
| アクション | 必須 | 任意 | 提供方式 | 上限 | 1,000件あたり | レスポンスフィールド |
|---|---|---|---|---|---|---|
search検索
| keyword | sort | Sync配信 | カタログ値:defaultLimit=10、maxLimit=25。アクションによってはlimitがページ数や親要素ごとの展開数を制御するため、必ずしも最終的な行数にはなりません。より大きいlimitも指定できますが、25が上限として適用されます。 | 1,000リクエストあたり$0.56 | id · url · title · text · author_username · community · like_count · comment_count · posted_at · flair · domain · external_link · thumbnail_url · image_urls · platform |
subreddit_postsサブレディットの投稿 サブレディット名(pythonなど)またはURLで、Redditコミュニティの投稿を閲覧します。投稿者、本文、いいね数、コメント数を取得でき、期間と並び順で絞り込めます。rで始まる名前の場合は、/r/を含む完全なURLを指定してください。非公開の投稿や削除された投稿は含まれません。 | subreddit | date_range, sort | Sync配信 | カタログ値:defaultLimit=10、maxLimit=100。アクションによってはlimitがページ数や親要素ごとの展開数を制御するため、必ずしも最終的な行数にはなりません。 | 1,000リクエストあたり$0.56 | id · url · title · text · author_username · community · like_count · comment_count · posted_at · flair · domain · external_link · thumbnail_url · image_urls · platform |
post_detail投稿詳細 リンクからRedditの投稿を1件開きます。タイトル、本文、投稿者、サブレディット、いいね数、コメント数を取得できます。コメントは含まれません。コメントは同じ | url | — | Sync配信 | — | 1,000リクエストあたり$0.56 | id · url · title · text · author_username · community · like_count · comment_count · posted_at · flair · domain · external_link · thumbnail_url · image_urls · platform |
commentsコメント Redditの1件の投稿に付いたコメントを、最大5階層のネストされた返信とともに読み取ります。各コメントには本文、投稿者、スコア、日時が含まれます。対象はその投稿のみで、サイト全体のコメント検索ではありません。スレッドのすべての分岐を取得できるとは限りません。 | url | — | Sync配信 | カタログ値:defaultLimit=10、maxLimit=100。アクションによってはlimitがページ数や親要素ごとの展開数を制御するため、必ずしも最終的な行数にはなりません。 | 1,000リクエストあたり$0.56 | id · text · author_username · like_count · community · url · posted_at · platform |
user_postsユーザーの投稿 ユーザー名または/user/のURLで、Redditユーザーが投稿した内容を取得します。サブレディット、本文、いいね数、コメント数を取得でき、期間と並び順で絞り込めます。メッセージと非公開の投票は除外され、すべての投稿の取得は保証されません。uで始まるユーザー名の場合は、完全なURLを指定してください。 | username | date_range, sort | Sync配信 | カタログ値:defaultLimit=10、maxLimit=50。アクションによってはlimitがページ数や親要素ごとの展開数を制御するため、必ずしも最終的な行数にはなりません。 | 1,000リクエストあたり$0.56 | id · url · title · text · author_username · community · like_count · comment_count · posted_at · flair · domain · external_link · thumbnail_url · image_urls · platform |
user_commentsユーザーのコメント ユーザー名、u/name、またはプロフィールURLで、Redditユーザー1人のコメント履歴を読み取ります。各コメントには本文、スコア、日時と、コメント先の投稿のタイトル、ID、リンクが含まれます。新着順(デフォルト)、トップ、人気、議論の多い順で並べ替えでき、1回の呼び出しで最大200件のコメントを取得できます。 | username | sort | Sync配信 | カタログ値:defaultLimit=20、maxLimit=200。アクションによってはlimitがページ数や親要素ごとの展開数を制御するため、必ずしも最終的な行数にはなりません。 | 1,000リクエストあたり$32.4 | id · text · author_username · like_count · post_id · post_title · url · posted_at · platform |
painpointペインポイント 製品やトピックの | keyword | sort | Sync配信 | カタログ値:defaultLimit=5、maxLimit=15。アクションによってはlimitがページ数や親要素ごとの展開数を制御するため、必ずしも最終的な行数にはなりません。 | 1,000リクエストあたり$72 | row_type · posts_scanned · posts_analyzed · comments_collected · negative_comment_count · positive_comment_count · pain_keywords · praise_keywords · communities · platform · id · title · url · community · like_count · comment_count · text · author_username · post_title |
trending_postsトレンド投稿 入力なしで、Reddit全体で現在トレンドになっている投稿を読み取ります。各投稿には、タイトル、本文、サブレディット、投稿者、スコア、コメント数、投稿日時、および外部リンクまたは画像(ある場合)が含まれます。プロモーション投稿は除外されます。1ページあたり25件で、 | page_token | Sync配信 | 1回の呼び出しで最大25行の1ページを返します。行数はページごとに異なるため、行数が少なくても最後のページとは限りません。次のページを取得するには、レスポンスのトップレベルにあるnext_page_tokenをpage_tokenとして渡し、next_page_tokenがなくなったら終了します。limitは指定できますが、効果はありません。 | 1,000リクエストあたり$0.56 | next_page_token · id · url · title · text · author_username · community · like_count · comment_count · posted_at · domain · external_link · image_urls · platform |
Redditのsearchのパラメータはそれぞれどういう意味ですか?
keywordで過去1か月のReddit投稿を検索し、サブレディット、投稿者、本文、いいね数、コメント数を取得します。sortで指定しない限り関連度順に並びます。コメント本文は検索対象外で、それより古い投稿の取得は保証されません。
keyword必須searchで使用する投稿の検索クエリを指定します。コメントの全文は検索しません。並び順はデフォルトでrelevance、期間は過去1か月に固定されます。返されるのはクエリに一致する投稿のみです。一致とみなされるのは、クエリの単語がタイトルまたはコミュニティ名に含まれ、かつ投稿にクエリの単語が含まれる場合、または本文中でクエリの単語が近接して出現する場合です(3語以上のクエリでは、そのうち少なくとも4分の3が必要です)。共通する単語が1語だけの投稿は除外されるため、件数がlimitに満たないことがあります。一致する投稿がない場合は空の結果が返され、その呼び出しは返金されます。sort任意- Redditの投稿一覧を
newest、popular、relevance、rising、topのいずれかで並べ替えます。post_detailおよびcommentsアクションはsortを受け付けません。指定可能な値:controversialnewestpopularrelevancerisingtopReddit:Relevance、Hot、Top、Newの違い — Redditの公式ドキュメントでは、Hot(最近のインタラクションに基づく)とTop(全期間で投票数が多い)を区別しています。このページのpopularはTopではなくHotに対応します。公式サイトに追加の並べ替えや期間フィルターがあっても、このエンドポイントが同じパラメータやその組み合わせをサポートしているわけではありません。 · 確認日
Redditのsubreddit_postsのパラメータはそれぞれどういう意味ですか?
サブレディット名(pythonなど)またはURLで、Redditコミュニティの投稿を閲覧します。投稿者、本文、いいね数、コメント数を取得でき、期間と並び順で絞り込めます。rで始まる名前の場合は、/r/を含む完全なURLを指定してください。非公開の投稿や削除された投稿は含まれません。
完全なAPIリファレンス:パラメータ、コードサンプル、レスポンス例、稼働状況subreddit必須subreddit_postsの対象サブレディットを、pythonのような名前または完全なサブレディットURLで指定します。rで始まるサブレディット名の場合は、完全な/r/subreddit/URLを渡し、結果を確認してください。Reddit:コミュニティ内検索とサイト全体の検索 — Redditヘルプセンターでは、特定のコミュニティ内での検索とサイト全体の検索を区別しています。subredditは投稿が属するコミュニティを指定するものです。ここで検索範囲の用語に触れていても、公式検索ボックスのブール演算子、フレア、その他のフィルターがこのエンドポイントの機能として自動的に使えるようになるわけではありません。 · 確認日date_range任意- サブレディットおよびユーザーの投稿一覧で、期間により投稿を絞り込みます。指定できる値は
all_time、past_hour、past_day、past_week、past_month、past_yearです。特定の投稿URLや、サポートされていない並び順を使用する場合、絞り込みが適用されるかどうかは結果セットによって異なります。コメントを日付で絞り込むことはできません。指定可能な値:all_timepast_daypast_hourpast_monthpast_weekpast_year sort任意- Redditの投稿一覧を
newest、popular、relevance、rising、topのいずれかで並べ替えます。post_detailおよびcommentsアクションはsortを受け付けません。指定可能な値:newestpopularrelevancerisingtopReddit:Relevance、Hot、Top、Newの違い — Redditの公式ドキュメントでは、Hot(最近のインタラクションに基づく)とTop(全期間で投票数が多い)を区別しています。このページのpopularはTopではなくHotに対応します。公式サイトに追加の並べ替えや期間フィルターがあっても、このエンドポイントが同じパラメータやその組み合わせをサポートしているわけではありません。 · 確認日
Redditのpost_detailのパラメータはそれぞれどういう意味ですか?
リンクからRedditの投稿を1件開きます。タイトル、本文、投稿者、サブレディット、いいね数、コメント数を取得できます。コメントは含まれません。コメントは同じurlでcommentsを使って取得してください。
url必須post_detailおよびcommentsの対象投稿URLを指定します。通常は/r/subreddit/comments/post_id/を含みます。commentsでは、その投稿のコメントと最大5階層までのネストされた返信を取得します。全体を対象としたコメント検索ではありません。Reddit:投稿のインタラクション数と投稿者のカルマ — Redditはカルマを、投稿やコメントが受けた投票をおおまかに反映するものと説明しており、賛成票とカルマが1対1で対応しないことを明記しています。このエンドポイントには投稿者のカルマを示すフィールドがなく、like_countや1件の投稿に対するインタラクションの集計値をアカウントのカルマに換算することもありません。 · 確認日
Redditのcommentsのパラメータはそれぞれどういう意味ですか?
Redditの1件の投稿に付いたコメントを、最大5階層のネストされた返信とともに読み取ります。各コメントには本文、投稿者、スコア、日時が含まれます。対象はその投稿のみで、サイト全体のコメント検索ではありません。スレッドのすべての分岐を取得できるとは限りません。
完全なAPIリファレンス:パラメータ、コードサンプル、レスポンス例、稼働状況url必須post_detailおよびcommentsの対象投稿URLを指定します。通常は/r/subreddit/comments/post_id/を含みます。commentsでは、その投稿のコメントと最大5階層までのネストされた返信を取得します。全体を対象としたコメント検索ではありません。Reddit:投稿内のコメント検索とコメントの取得 — Redditの公式ドキュメントでは、Webサイトとアプリで投稿内のコメントを検索する機能について説明しています。このページのcommentsエンドポイントは投稿URLのみを基にコメントを取得します。コメントのキーワードパラメータはなく、公式の機能説明を参照しているからといってコメントの全文検索をサポートするわけではありません。 · 確認日
Redditのuser_postsのパラメータはそれぞれどういう意味ですか?
ユーザー名または/user/のURLで、Redditユーザーが投稿した内容を取得します。サブレディット、本文、いいね数、コメント数を取得でき、期間と並び順で絞り込めます。メッセージと非公開の投票は除外され、すべての投稿の取得は保証されません。uで始まるユーザー名の場合は、完全なURLを指定してください。
完全なAPIリファレンス:パラメータ、コードサンプル、レスポンス例、稼働状況username必須user_postsで使用するユーザー名または完全な/user/username/URLを指定します。uで始まるユーザー名の場合は、完全なURLを渡し、結果を確認してください。user_commentsでも、ユーザー名、u/username、またはプロフィールURLを指定できます。Reddit:公開コンテンツ、商用ライセンス、ユーザーの権利の範囲 — Redditの公開コンテンツポリシーでは、閲覧可能なコンテンツとライセンスを受けた商用利用を明確に区別しています。商用利用者にはRedditへの連絡を求め、削除の同期や機微な情報に基づくプロファイリングの制限などを課しています。公開投稿にアクセスできてもプラットフォームのライセンスが付与されるわけではありません。プライベートメッセージ、非公開コミュニティ、削除済みコンテンツは、公開コンテンツのライセンス範囲外です。 · 確認日date_range任意- サブレディットおよびユーザーの投稿一覧で、期間により投稿を絞り込みます。指定できる値は
all_time、past_hour、past_day、past_week、past_month、past_yearです。特定の投稿URLや、サポートされていない並び順を使用する場合、絞り込みが適用されるかどうかは結果セットによって異なります。コメントを日付で絞り込むことはできません。指定可能な値:all_timepast_daypast_hourpast_monthpast_weekpast_year sort任意- Redditの投稿一覧を
newest、popular、relevance、rising、topのいずれかで並べ替えます。post_detailおよびcommentsアクションはsortを受け付けません。指定可能な値:newestpopularrelevancerisingtop
Redditのuser_commentsのパラメータはそれぞれどういう意味ですか?
ユーザー名、u/name、またはプロフィールURLで、Redditユーザー1人のコメント履歴を読み取ります。各コメントには本文、スコア、日時と、コメント先の投稿のタイトル、ID、リンクが含まれます。新着順(デフォルト)、トップ、人気、議論の多い順で並べ替えでき、1回の呼び出しで最大200件のコメントを取得できます。
完全なAPIリファレンス:パラメータ、コードサンプル、レスポンス例、稼働状況username必須- コメント履歴を取得するRedditユーザー名を1つ指定します。
spez、u/spez、https://www.reddit.com/u/spezのいずれの形式も使えます。1回の呼び出しにつき1ユーザーです。 sort任意user_commentsのコメントの並び順です。newest(デフォルト)、top、popular、controversialのいずれかを指定します。指定可能な値:controversialnewestpopulartop
Redditのpainpointのパラメータはそれぞれどういう意味ですか?
製品やトピックのkeywordについて、Redditで人々が何に不満を持っているかを調査します。最初の要約1件に、読み取った投稿とコメントの数、否定的・肯定的なコメント数、最も多く繰り返された不満と称賛の単語、関係するコミュニティがまとまり、続いて上位の投稿と、最も支持された否定的コメントの全文が返ります。不満と称賛は単語リストで判定するため、カウントは大まかな目安として扱ってください。limitで分析する投稿数(2〜15)を指定します。
keyword必須- 調査する製品またはトピックです(例:
standing desk)。このキーワードでRedditのディスカッションを探し、そのコメントを分析します。コメント検索ではありません。 sort任意- 分析するディスカッションの選び方です。
relevance(デフォルト)、popular、top、newest、most_commentedのいずれかを指定します。限定的なキーワードで結果が返らない場合は、topを試してください。指定可能な値:most_commentednewestpopularrelevancetop
Redditのtrending_postsのパラメータはそれぞれどういう意味ですか?
入力なしで、Reddit全体で現在トレンドになっている投稿を読み取ります。各投稿には、タイトル、本文、サブレディット、投稿者、スコア、コメント数、投稿日時、および外部リンクまたは画像(ある場合)が含まれます。プロモーション投稿は除外されます。1ページあたり25件で、next_page_tokenで次のページに進めます。
page_token任意trending_postsのページトークンです。最初のページでは省略し、以降は前回のレスポンスのnext_page_tokenを受け取ったとおりそのまま渡してください。
Reddit APIの使い方
- 01公開カタログからプラットフォームのアクションを選択します。
- 02プラットフォーム、アクション、必須パラメータをPOST /api/v1/socialに送信します。
- 03レスポンスから結果を読み取ります。非同期のアクションの場合は、返されたジョブIDをポーリングします。
- 04アプリケーションで必要なレスポンスフィールドを保存します。
curl -X POST https://api.everyinfra.com/api/v1/social \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"platform":"reddit","action":"search","params":{"keyword":"<keyword>"}}'
Redditのガイド
これらのアクションを使った実践例と手法です。まずこのページで現在のアクション、パラメータ、フィールドを確認してください。記事内の例や制限は、最新のカタログに代わるものではありません。
Redditのコメント収集が不完全になる理由:MoreCommentsを空データとして扱わない
Redditのコメントツリー、PRAWのreplace_moreにおけるlimitの意味、未展開のプレースホルダー、コメント数の不一致について解説し、収集の欠落、返信関係、削除の扱いを分析結果に引き継ぐ方法を紹介します。
記事を読むマルチプラットフォームの評判モニタリング設計:ネガティブな変化を評価する前に範囲を決める
監視対象リスト、コメントの識別子、増分カーソルを起点に、追跡可能な評判モニタリングのワークフローを設計します。オフラインのサンプルで重複排除と取り込み漏れを示しつつ、人によるレビューを維持します。
記事を読む統合データAPI入門:機能カタログから最初の有効な結果を得るまで
platform、action、paramsで複数プラットフォームのデータにアクセスします。機能カタログの読み方、最小限のリクエストの送信、非同期タスク・部分的な結果・課金の扱い方、追跡可能なデータ記録の作り方を解説します。
記事を読むReddit APIに関する質問
Reddit APIでは何を取得できますか?
platformをredditに設定します。現在のカタログには検索、サブレディットの投稿、投稿詳細、コメント、ユーザーの投稿、moreが掲載されています。これらのアクション名はそれぞれ異なるRedditのオブジェクトやビューを表すもので、互いに置き換えられる検索モードではありません。
Redditに公式APIはありますか?
はい。RedditはData APIを提供していますが、利用にはResponsible Builder Policyに基づくRedditの明示的な承認が必要です。無料での利用は非商用に限られ、レート制限はOAuthクライアントごとに毎分100クエリです。商用利用には、Redditとの個別の書面契約が必要です。
公式情報源: Reddit:Responsible Builder Policy · Reddit Data API利用規約 · 確認日
Redditの開発者アカウントやAPIキーは必要ですか?
いいえ、不要です。リクエストはEveryInfraのAPIキーを使ってEveryInfra経由で送信します。新規登録後、コンソールでキーを作成し、Authorization: Bearer <API_KEY>として送信してください。Redditの開発者アプリの登録、Reddit APIへのアクセス申請、Redditアカウントでのログインは必要ありません。また、アクションが返すのはRedditの公開データのみです。
Reddit APIの料金は1,000リクエストあたりいくらですか?
アクションに応じて1,000リクエストあたり$0.56から、各アクションの料金は、このページの表と公開カタログに記載されています。サブスクリプションはなく、USD残高をチャージして呼び出しごとに料金を支払います。失敗した呼び出しや結果が空の場合は課金されません。
Redditのsearchリクエストを開始するには、どの入力を使用しますか?
searchで使用する投稿の検索クエリを指定します。コメントの全文は検索しません。並び順はデフォルトでrelevance、期間は過去1か月に固定されます。返されるのはクエリに一致する投稿のみです。一致とみなされるのは、クエリの単語がタイトルまたはコミュニティ名に含まれ、かつ投稿にクエリの単語が含まれる場合、または本文中でクエリの単語が近接して出現する場合です(3語以上のクエリでは、そのうち少なくとも4分の3が必要です)。共通する単語が1語だけの投稿は除外されるため、件数がlimitに満たないことがあります。一致する投稿がない場合は空の結果が返され、その呼び出しは返金されます。params内のkeywordとして送信してください。
Redditのsearchはどのフィールドを返しますか?
宣言されたスキーマにはtitle、text、author_username、communityが含まれます。宣言されたフィールドでも個々のレコードには含まれない場合があり、他のアクションにはそれぞれ独自のフィールド一覧があります。
Redditのアクションはすべて即座に結果を返しますか?
非同期と表示されたアクションはジョブIDを返すので、そのIDをポーリングします。それ以外のすべてのアクションも非同期で実行できます。リクエストボディに"mode": "async"を追加するとすぐにジョブIDが返されるため、時間のかかるタスクや上限値を大きく設定する場合に便利です。現在のカタログにはsync配信が含まれています。