認証と課金基準
Reddit Posts APIはRedditと提携しない独立した履歴アーカイブです。保護された取得にはAuthorization: Bearer YOUR_API_KEYまたはX-API-Key: YOUR_API_KEYを指定できます。どちらも有効です。/v1/statusはキー不要で無料です。キーと残高はredditpostsapi.com専用で、アカウント画面のセッションと取得ヘッダーの認証は別です。
成功した取得は空結果も1クレジットです。1000回で$1、最低$50の有料チャージで50000クレジットです。登録時、支払い前にキーが一度表示されます。試用の100クレジットはネットワーク全体の不正利用防止条件に応じて提供され、全アカウントには保証されません。有料クレジットは失効せずサブスクリプションはありません。
不正なリクエストは課金されず、取得元の失敗では予約クレジットが返還されます。クライアントが応答を受け取れなくてもサーバーで成功している場合があり、成功した再試行には新しいクレジットが必要です。無料の/v1/statusは静的な説明とHTTP応答だけを示し、検索基盤、特定の記録、アーカイブの範囲を検査しません。
ルートのパラメータとフィルター
GET /v1/searchで使える条件はq、subreddit、author、kind、from、to、min_score、limit、pageです。kindはpostまたはcommentです。fromとtoはUTCのYYYY-MM-DDで、toの日を含みます。日付は任意の条件であり、時刻単位の範囲指定ではありません。共通条件がすべてのルートで使えるわけではなく、単独項目やコミュニティ探索は別の引数です。
limitパラメータは1から100、pageパラメータは1から100の範囲で設定できます。また、min_scoreはスコアのソート制御ではなく、あくまで結果をフィルタリングするためのものです。結果の順序はアーカイブの内部順序に従い、時系列や関連度順ではありません。
GET /v1/itemにはidが必要で、GET /v1/postsとGET /v1/commentsにidは使いません。GET /v1/subredditsはprefixとlimitでコミュニティ名を探索し、集計が全体の厳密な件数とは限りません。1回100件、1クエリ100ページまででも全件取得は保証されません。期間を分けても欠落や重複を防ぐ保証にはなりません。
エラーコードとレスポンス形式
HTTP 400は不正なリクエスト、401はキーの欠落または無効、402は残高不足、429はレート制限です。条件やキーの問題を修正してから再試行し、429では待機してください。これらのコードはASCII数字です。有効なキーだけで成功や記録の存在が保証されるわけではありません。結果を受け取って検証してからローカル進捗を更新します。
APIのレスポンスはフラットなレコードとして返されます。スレッドツリー形式ではなく、サーバーは会話の先祖情報を組み立てません。parent_idやlink_idフィールドが含まれていても、クライアント側でグループ化は任意です。完全な会話履歴が保証されるわけではありません。
総数の関係値はeqが正確、gteが下限、unknownが不明を意味し、総数がnullの場合もあります。これは一致レコードの件数で、総ページ数ではありません。正確な件数でも全件を受信した証明にはなりません。空の成功応答は、その条件の今回の応答に記録がなかったという意味であり、投稿が過去に存在しなかったことの証明には使えません。
