コンテンツへスキップ
JA
APIキーを取得する
ドキュメントを探す

API リファレンス

レスポンス形式

お使いのアプリケーションやMarkdownコンテンツをAIエージェント用に構造化したJSONを選択します。 2つのヘッダーで応答を制御します。

このページの内容

フォーマットを選択する

JSON は、元の結果フィールドでデフォルトです。 Accept は JSON か明白なテキストを選びます; X-Respond-With: マークダウンは、結果のコンテンツをMarkdownに変換します。 JSON をリクエストするボディ。

レスポンスAcceptX-Respond-With用途・用途
JSONapplication/jsonオミットコード・デフォルトでフィールドをパースする
JSON + Markdownapplication/jsonmarkdown構造化されたメタデータを持つエージェントのコンテキスト
テキストをクリアするtext/plainオミットターミナルで元のフィールドを読み込む
テキスト+ Markdowntext/plainmarkdownメタデータとMarkdownを一緒に読む

リクエストと応答例

これらのタブは、各フォーマットで同じGoogle Searchを表示します。 Bash と cURL 7.76+ を FLASHDATA_API_KEY で使用して、google_search をキーに設定します。 コマンドを実行すると、1つの課金可能な検索を送信します。

デフォルト。 結果の配列をパースします。その中のフィールドはソースに依存します。

要求 · cURL/Bash
curl --fail-with-body --silent --show-error \
  'https://data.flashdata.dev/v1/queries/realtime' \
  --header "X-API-Key: ${FLASHDATA_API_KEY:?Set FLASHDATA_API_KEY}" \
  --header 'Content-Type: application/json' \
  --header 'Accept: application/json' \
  --data '{"source":"google_search","query":"vector databases"}'
例応答・イラスト値
{
  "source": "google_search",
  "status": "done",
  "results": [
    {
      "organic": [
        {
          "title": "Example page",
          "link": "https://example.com/article",
          "snippet": "A short source snippet."
        }
      ]
    }
  ],
  "usage": {
    "credits": 0.01
  },
  "created_at": "2026-10-22T12:00:00.000Z"
}

サポートされているエンドポイント

同じルールは、Google Search と YouTube クエリソースに適用されます。 YouTube Downloadでは、配信記録をフォーマットし、ビデオやオーディオバイトではなく、配信記録をフォーマットします。 口座API、Bulkマニフェスト、NDJSONパーツ、コールバック、MCPレスポンスは独自のフォーマットを使用します。

エンドポイントJSON/プレーンテキストMarkdown コンテンツ
POST /v1/queries/realtimeサポートサポート
GET /v2/jobs/{id}/resultsサポートサポート
POST /v1/queries応募受付無視 — 結果を読むときに選択する
POST /v1/queries/batch応募受付無視 — 結果を読むときに選択する
GET /v2/jobs/{id}ジョブステータス無視される — 結果のコンテンツはここにありません

完了したジョブ結果の形式

結果を読むときにヘッダーを設定します。送信時に設定しても。 JOB_ID を完成したジョブにセットします。 このGETは、別のクエリを送信せずに既存の結果を読み込みます。

リクエスト形式結果の応答
オリジナルJSON302 は、位置の署名されたストレージ URL と。 それをフェッチ URL 別々に、なし X-API-Key. 保存した結果は、gzip-compressed です。
テキストまたはMarkdownオプションのいずれかをプレーする200 は、整形されたボディを直接応答で指定します。
リトリーブ Markdown 内側に JSON · cURL / Bash
curl --fail-with-body --silent --show-error \
  "https://api.flashdata.dev/v2/jobs/${JOB_ID:?Set JOB_ID}/results" \
  --header "X-API-Key: ${FLASHDATA_API_KEY:?Set FLASHDATA_API_KEY}" \
  --header 'Accept: application/json' \
  --header 'X-Respond-With: markdown'

フォーマットエラー

API エラーは、テキストを要求しても JSON または application/problem+json のままです。 HTTP ステータスを確認して、成功のフォーマットを解析します。

ステータス/コードフィックス
400 · unsupported_representationX-Respond-With: マークダウンまたはヘッダーの省略を使用してください。 json や text などの値はサポートされません。
406 · not_acceptableAccept: application/json または text/plain. text/markdown および application/xml はサポートされていません。

Accept ヘッダーの詳細

Accept を省略するか、*/* を JSON を得るために送って下さい。 応答は、UTF-8を使用します。 媒体の範囲およびqの重量は支えられます;支持されていないcharsetは別の受諾可能な範囲が一致しなければ406を戻します。 Content-Type:application/jsonは応答ではなく、要求ボディを記述します。

テキストを優先し、JSONを割り当てて下さい
Accept: text/plain; charset=utf-8, application/json;q=0.8