その項目を、出力テーブルでどう使いますか

Reddit Extractの小さなPostgreSQL応答で項目を確認します。タイトルと本文、欠損値と変換結果を区別し、手元の出力ルールを決めます。

リクエスト例

cURL

curl --fail-with-body -H "Authorization: Bearer YOUR_API_KEY" "https://api.redditextract.com/v1/search?q=index&subreddit=PostgreSQL&limit=3"

架空のレスポンス例（抜粋）

説明用のサンプルです。実際のアーカイブレコードではありません。

{
  "data": [
    {
      "kind": "post",
      "subreddit": "PostgreSQL",
      "title": "Demo: checking an index",
      "text": "Fictional example for mapping available fields."
    }
  ]
}

data のみを表示しています。返されるフィールドは異なる場合があり、完全なレスポンスではありません。

PostgreSQLの小さな要求で出力の前提を試す

PostgreSQLの資料を入れるテーブルが本文を必須にしていても、取得した記録には使えるタイトルしかないかもしれません。大きな取得を始める前に、この差をどう扱うか決めます。indexの小さな検索は、コピーする値、欠損のまま残す値、確認に回す記録を選ぶための出発点です。

Reddit ExtractはRedditの過去アーカイブへアクセスする独立したAPIです。公式サービスでも提携サービスでもなく、ライブデータは提供しません。データ変換を行う開発者は、まず少量の記録から実際の項目名と値を確認できます。すべての記録に同じ項目や型がある保証はありません。一貫した出力形式は利用者の変換処理で定義するもので、サーバーが保証する固定のエクスポートスキーマではありません。

例はGET https://api.redditextract.com/v1/search?q=index&subreddit=PostgreSQL&limit=3です。q=indexは文章の検索、subredditはコミュニティの指定、limit=3は最大三件の要求です。三件が必ず返るわけではなく、空の場合もあります。Authorization: Bearer YOUR_API_KEYまたはX-API-Key: YOUR_API_KEYを使い、実値は信頼できるサーバーで設定します。この例は実行済みの応答や特定の投稿の存在を示していません。

タイトルをそのまま本文の代わりにしない

titleとtextがあれば、最初は別々に確認します。後で一つの列にまとめる場合は、加工した内容であることと元の項目名を残してください。タイトルがindexに一致しても、本文にその語があるとは限りません。タイトルによる代用は自分のアプリケーションの判断であり、元の本文として表示するものではありません。

欠けている値の扱いを決める

実際に返されたid、kind、文章や日時などの項目を、必要な出力列へ対応付けます。項目が存在しない状態、null、空文字列、数値のゼロは区別してください。出力先で必須の列がない場合、推測で値を補うのではなく、保留や除外などの方針を決めます。項目名だけで型や単位を判断せず、どの記録に何があったかを残すと変換の理由を説明できます。

会話を補わずに参照を残す

識別子を計算用の数値に変換すると表記を失う場合があります。日時の単位や数値らしい文字列も確認してから変換します。元の値と変換後の値を分け、失敗した項目と規則の版を記録してください。文字の整形や型の統一はローカル処理です。APIが項目の正規化、品質判定、出力テーブルの作成を代行するわけではありません。parent_idやlink_idによる任意の関係整理も欠けた親を復元しません。

一回の要求は最大100レコード、一クエリは最大100ページです。_doc文書順は時系列、関連度、スコア順ではありません。ページ反復や日付分割で全件取得や重複のない結果は保証されません。min_scoreも最低点の条件であり並べ替えではありません。取得条件、UTCでの取得日時、実際の件数と終了理由を残し、出力が正常に作れたことと資料の完全性を混同しないでください。

項目確認を具体的な抽出ルールにつなげる

成功した取得は空でも一クレジットです。成功した取得リクエスト1,000回で$1、最低$50の追加で有料50,000クレジットです。定期契約はなく有料分は失効しません。試用100クレジットはネットワーク全体の不正利用防止条件によります。保存済み応答の再変換は新しい要求ではありませんが、再取得の成功は別料金です。公開非課金の/v1/statusは静的説明とHTTP応答のみで、資料や検索基盤の状態を検査しません。

最初の確認で作るのは、各列の出所、受け入れる状態、除外時の扱いをまとめた短いルールです。ガイドでは保存済み応答でその判断を試します。取得パラメータはドキュメントで確認し、サーバーから要求する準備ができたらキーのページでアクセスを設定してください。