ドキュメントを探す
API リファレンス
お使いのアプリケーションやMarkdownコンテンツをAIエージェント用に構造化したJSONを選択します。 2つのヘッダーで応答を制御します。
このページの内容
フォーマットを選択する
JSON は、元の結果フィールドでデフォルトです。 Accept は JSON か明白なテキストを選びます; X-Respond-With: マークダウンは、結果のコンテンツをMarkdownに変換します。 JSON をリクエストするボディ。
| レスポンス | Accept | X-Respond-With | 用途・用途 |
|---|---|---|---|
| JSON | application/json | オミット | コード・デフォルトでフィールドをパースする |
| JSON + Markdown | application/json | markdown | 構造化されたメタデータを持つエージェントのコンテキスト |
| テキストをクリアする | text/plain | オミット | ターミナルで元のフィールドを読み込む |
| テキスト+ Markdown | text/plain | markdown | メタデータとMarkdownを一緒に読む |
リクエストと応答例
これらのタブは、各フォーマットで同じGoogle Searchを表示します。 Bash と cURL 7.76+ を FLASHDATA_API_KEY で使用して、google_search をキーに設定します。 コマンドを実行すると、1つの課金可能な検索を送信します。
デフォルト。 結果の配列をパースします。その中のフィールドはソースに依存します。
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"
}Markdown 文字列としてコンテンツを読み込みます。 JSON フィールドとして、ソース、ステータス、使用状況が使用可能です。
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' \
--header 'X-Respond-With: markdown' \
--data '{"source":"google_search","query":"vector databases"}'{
"source": "google_search",
"status": "done",
"usage": {
"credits": 0.01
},
"created_at": "2026-10-22T12:00:00.000Z",
"content": "# Google search\n\n## Organic\n\n### 1. Example page\n\n**Link:** <https://example.com/article>\n\n**Snippet:** A short source snippet\\.\n"
}応答をテキストとして読みます。 JSONドキュメントではなく、インデントされたレイアウトに元のフィールドが含まれています。
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: text/plain' \
--data '{"source":"google_search","query":"vector databases"}'Source: "google_search"
Status: "done"
Results:
1:
Organic:
1:
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"
応答をテキストとして読みます: メタデータを最初に、Markdown コンテンツに従って、.
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: text/plain' \
--header 'X-Respond-With: markdown' \
--data '{"source":"google_search","query":"vector databases"}'Source: "google_search"
Status: "done"
Usage: {"credits":0.01}
Created at: "2026-10-22T12:00:00.000Z"
Markdown Content:
# Google search
## Organic
### 1. Example page
**Link:** <https://example.com/article>
**Snippet:** A short source snippet\.
サポートされているエンドポイント
同じルールは、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は、別のクエリを送信せずに既存の結果を読み込みます。
| リクエスト形式 | 結果の応答 |
|---|---|
| オリジナルJSON | 302 は、位置の署名されたストレージ URL と。 それをフェッチ URL 別々に、なし X-API-Key. 保存した結果は、gzip-compressed です。 |
| テキストまたはMarkdownオプションのいずれかをプレーする | 200 は、整形されたボディを直接応答で指定します。 |
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_representation | X-Respond-With: マークダウンまたはヘッダーの省略を使用してください。 json や text などの値はサポートされません。 |
| 406 · not_acceptable | Accept: application/json または text/plain. text/markdown および application/xml はサポートされていません。 |
Accept ヘッダーの詳細
Accept を省略するか、*/* を JSON を得るために送って下さい。 応答は、UTF-8を使用します。 媒体の範囲およびqの重量は支えられます;支持されていないcharsetは別の受諾可能な範囲が一致しなければ406を戻します。 Content-Type:application/jsonは応答ではなく、要求ボディを記述します。
Accept: text/plain; charset=utf-8, application/json;q=0.8