経路と認証情報
取得先はhttps://api.getredditdata.comです。GET /v1/searchは一般検索、/v1/postsは投稿、/v1/commentsはコメント一覧です。/v1/item?id=...は既知の識別子で一件を探し、/v1/subreddits?prefix=...はコミュニティ名を接頭辞で絞ります。/v1/statusは静的なサービス範囲を公開します。独立した過去のアーカイブであり、公式Redditサービス、ライブ配信、OAuth、書き込み、投票やメッセージ機能はありません。記録全体を代表する標本や、全削除コンテンツの復元サービスと説明しないでください。
Authorization: Bearer YOUR_API_KEYとX-API-Key: YOUR_API_KEYは両方有効です。このドメインのアーカイブキーを使い、Reddit OAuthトークンを入れないでください。実値はサーバーで追加し、公開コードや表へ残しません。パネルのSecure HttpOnlyセッションCookieは取得認証と別です。アカウント、キー、残高は他ブランドへ共用できません。GET https://api.getredditdata.com/v1/search?q=sampling&subreddit=AskStatistics&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です。無効な要求は差し引かれず、上流失敗では予約分が戻ります。クライアントのタイムアウトはサーバー失敗の証明ではありません。応答が失われた場合は、成功した再試行に追加費用がかかることがあります。読み取り専用でも固定応答や無料再試行は保証されません。取得結果、ローカル保存、表の変換を分けて記録します。既存のJSONを再処理することと、新しいAPI要求で再取得することを区別してください。
400は引数や値の修正、401は欠落または無効なキーの確認、402は残高確認、429は頻度低下が必要です。試行回数と停止条件を設け、別アカウントで制限を回避しないでください。/v1/statusは公開非課金ですが、静的な範囲とHTTP応答だけで検索、記録、キー、残高は検査しません。日付分割やページ反復、重複除去でも全体の網羅性と一意性は保証されません。取得条件、受信したページ、ローカル変換と不確実性を残しても、将来同じ結果が再取得できる保証にはならない点に注意してください。
