Reddit API Hub
言語の選択

コミュニティ名が必要なら名前の一覧から始める

prefix=programでコミュニティ名を検索します。検索、投稿、コメント、一件の取得を分け、応答の限界、キー、リクエスト費用を確認してください。

APIキーを取得

作業、データの種類、ルートを対応付ける

Reddit API Hubは独立した過去のRedditアーカイブへのアクセスを提供します。Redditの公式APIでも提携サービスでもありません。ライブの内容、OAuthセッション、投稿作成、投票、メッセージは提供しません。対応するエンドポイントを調べるときは、必要なのがコミュニティ名なのか、投稿やコメントの記録なのか、識別子が分かっている一件なのかを先に決めてください。

コミュニティ名の一覧を作る作業と、投稿本文の単語を探す作業は異なります。/v1/subredditsは名前の先頭部分で検索し、/v1/searchは投稿とコメントの記録を検索します。一つのルートの条件が他でもそのまま使えるとは考えないでください。ルートごとに入力と空の応答での動きを決め、異なる種類の情報を気付かず処理することを避けます。

ルートが存在しても、必要な記録やコミュニティの全履歴がアーカイブにある証拠にはなりません。網羅性、永続性、結果の不変性は保証されません。少量から試して、利用可能な応答を自分の用途と比べてください。このページは架空のコミュニティ在庫やライブ件数を示しません。APIの選択と、取得できるデータの範囲に関する判断を分けて扱います。

リクエスト例

cURL

curl --fail-with-body -H "Authorization: Bearer YOUR_API_KEY" "https://api.redditapihub.com/v1/subreddits?prefix=program&limit=3"

programで始まる名前を最大三件要求する

例はGET https://api.redditapihub.com/v1/subreddits?prefix=program&limit=3です。prefix=programはコミュニティ名の先頭部分を指定します。話題の分類でも、名前の任意の位置にある語を探す指定でもありません。limit=3は要求件数の上限で、三件の存在を保証しません。空の応答でも、Reddit全体にこの先頭部分の名前がないとは言えません。分かるのは自分の要求の結果です。

サーバーからAuthorization: Bearer YOUR_API_KEYまたはX-API-Key: YOUR_API_KEYの一方を送ります。YOUR_API_KEYは置き換え用です。本物は秘密設定に置き、ブラウザーのコード、URL、公開ログに含めません。返された名前をローカルの選択一覧に表示し、選択後に別の投稿要求を作ることができます。その要求は自分の条件と成功時の費用を持つ別の処理であり、一覧の一部として無料で実行されるわけではありません。

コミュニティの出力を完全な在庫、全体に対する正確な件数、保証されたアルファベット順として扱わないでください。手元で並べ替える場合は、受信した名前だけを対象にしていると説明します。一つの名前があっても、関連する全投稿やコメントが利用できるとは限りません。次の/v1/postsや/v1/commentsの応答は別に確認し、作り物の一覧を実際の結果の証明にしないでください。

小さな試験から取得作業へ

検索、投稿、コメントのクエリは一要求最大100件、一クエリ最大100ページです。ページごとに別に要求し、結果はアーカイブ文書順で、日時、関連度、スコア順ではありません。応答は平坦な記録です。関係の任意の整理は存在するフィールドだけを使い、欠けた会話を補いません。適切なルートを選んでも全件取得や重複のなさは保証されません。

成功した取得は空でも一回一クレジットです。成功1,000回が$1、一クレジットが$0.001、最低$50のチャージが有料クレジット50,000です。定期契約はなく、有料クレジットは失効しません。クライアントが応答を失う前にサーバーで成功する場合があり、成功した再試行は追加費用です。別ルートの試験や再取得も作業予算に含めてください。

メールとパスワードで登録すると、支払い前にキーが一度だけ表示されます。ネットワーク全体の不正利用対策で対象になったアカウントには試用クレジット100が付く場合がありますが、保証ではありません。アカウント、キー、残高はredditapihub.com専用です。ドキュメントはルート、ガイドは作業選択、料金は費用、APIキー取得は登録と請求書を説明します。最初は実際の残高から計画してください。