経路と認証
取得先はhttps://api.redditdatasets.comです。GET /v1/searchは一般検索、/v1/postsは投稿、/v1/commentsはコメントです。/v1/item?id=...は既知の識別子で一項目を調べ、/v1/subreddits?prefix=...はコミュニティ名を接頭辞で探します。/v1/statusは静的なサービス範囲の説明です。独立した過去アーカイブであり、公式Redditサービスではありません。ライブデータ、Reddit OAuth、書き込み、投票、メッセージは提供しません。条件付きの記録取得と、ラベル付きの完成済みデータセットや一括ダウンロードを混同しないでください。無作為抽出や不変の版を作る経路もありません。
Authorization: Bearer YOUR_API_KEYとX-API-Key: YOUR_API_KEYは両形式が有効です。このドメインのアーカイブキーを使い、Reddit OAuthトークンは入れません。実値はサーバーで設定し、共有ファイルやログから除外します。パネルのSecure HttpOnlyセッションCookieは別です。アカウント、キー、残高は他ブランドと共用できません。https://api.redditdatasets.com/v1/comments?subreddit=MachineLearning&limit=3は最大三件のコメントを要求し、三件の返却や無作為性を保証しません。対象コミュニティ、要求上限、実際の保存件数を出所メモで区別してください。
フィルター、順序、範囲
検索、投稿、コメントのフィルターはq、subreddit、author、kind、from、to、min_score、limit、pageです。kindはpostまたはcommentです。日付はUTCのYYYY-MM-DDで、toは指定日全体を含みます。min_scoreは最低スコア条件で並べ替えや品質検査ではありません。idは/v1/item専用で、投稿やコメント一覧の識別子フィルターではありません。parent_idとlink_idも応答の関係項目でクエリ引数ではありません。日付分割は計画の手段で、最後のレコードの日付は以前の期間が全て取得済みという証明でも新規データの安全な境界でもありません。
一要求最大100レコード、一クエリ最大100ページで、各ページは別呼び出しです。文書順は時間、関連度、スコア順ではありません。eqは正確な総数、gteは下限、unknownまたはnullは信頼できる総数が不明です。正確な数でも全件保存は証明しません。関係整理は任意で、閲覧や集計にツリーは不要、欠けた親も復元されません。ページ反復と重複除去で完全性や一意性は証明できず、コミュニティ集計も正確な全体在庫とは限りません。接頭辞検索も完全なアルファベット順一覧ではありません。
エラー、費用、ファイル状態
成功した取得は空でも一クレジットで、1,000回の成功は$1です。無効な要求は差し引かれず、上流失敗では予約分が戻ります。クライアントのタイムアウトはサーバー失敗の証拠ではありません。応答が失われた場合、成功した再試行は追加費用です。読み取り専用でも同一応答や無料の再試行は保証されません。API結果、ローカル保存、文章の整理、注釈判断を分けて管理します。保存済み応答の再処理は新しい呼び出しではありません。ローカルの版名はサーバーが不変である証明や、将来同じ資料を取得できる保証にはなりません。
400は引数修正、401はキー確認、402は残高確認、429は頻度低下が必要です。試行回数と停止条件を決め、他アカウントで制限を回避しないでください。/v1/statusは公開非課金でも静的範囲とHTTP応答のみで検索、記録、キー、残高は検査しません。仕事の各段階の実際の成功を確認します。完全性、永久保存、不変性、一定性能、継続的な可用性は保証されません。定期要求はライブ変更記録を作るわけでも更新頻度を証明するわけでもありません。認証の秘密を除いて条件と停止理由を記録してください。
APIのステータスチェックは/v1/statusエンドポイントで行います。これはアーカイブの健全性を確認するものではなく、HTTPサーバーが応答可能であることを示す静的な情報です。このエンドポイントへのリクエストはクレジットを消費しません。データのカバー範囲や検索バックエンドの状態に関する情報は提供されません。
