経路と認証
取得先はhttps://api.redditdatastream.comです。GET /v1/searchは一般検索、/v1/postsは投稿、/v1/commentsはコメントです。/v1/item?id=...は既知の一項目、/v1/subreddits?prefix=...はコミュニティ名の接頭辞検索です。/v1/statusは静的範囲を公開します。独立した過去アーカイブで公式Redditサービスではなく、ライブ配信、変更フィード、SSE、WebSocket、OAuth、書き込み、投票、メッセージもありません。クライアントがページを要求して処理し、完成済みJSONLやローカル書き込みのサーバー検証は提供されません。
Authorization: Bearer YOUR_API_KEYとX-API-Key: YOUR_API_KEYは両形式が有効です。このドメインのアーカイブキーを使いReddit OAuthトークンは入れません。実値はサーバーで設定し、ファイルとログから除外します。パネルのSecure HttpOnlyセッションCookieは別です。アカウント、キー、残高は他ブランドと共用できません。https://api.redditdatastream.com/v1/posts?subreddit=apacheairflow&limit=3&page=3は三ページ目の要求で三件の保証ではありません。pageは永続カーソルや時間境界ではなく、番号の保存は欠落のない再開や同一スナップショットの保証になりません。
フィルター、順序、範囲
検索、投稿、コメントのフィルターは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結果、JSONL書き込み、ロード先への反映を分け、保存済み応答の再処理は新しい呼び出しと区別します。ローカル進捗は固定スナップショットや一度だけの配送をサーバーが提供する証拠ではありません。
400は引数修正、401はキー確認、402は残高確認、429は頻度低下が必要です。試行回数と停止条件を決め、他アカウントで制限を回避しないでください。/v1/statusは公開非課金でも静的範囲とHTTP応答のみで検索、記録、キー、残高は検査しません。仕事の各段階の実際の成功を確認します。完全性、永久保存、不変性、一定性能、継続的な可用性は保証されません。定期要求はライブ変更記録を作るわけでも更新頻度を証明するわけでもありません。認証の秘密を除いて条件と停止理由を記録してください。
