# レスポンス形式

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

キャニシニカル参照: https://flashdata.dev/ja/docs/guides/response-formats
レビュー: FlashData による 2026-11-04

<a id="headers"></a>

## フォーマットを選択する

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を一緒に読む |


<a id="examples"></a>

## リクエストと応答例

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

### JSON

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

#### 要求 · cURL/Bash

```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"}'
```

#### 例応答・イラスト値

```json
{
  "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"
}
```


### JSON + Markdown

Markdown 文字列としてコンテンツを読み込みます。 JSON フィールドとして、ソース、ステータス、使用状況が使用可能です。

#### 要求 · cURL/Bash

```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' \
  --header 'X-Respond-With: markdown' \
  --data '{"source":"google_search","query":"vector databases"}'
```

#### 例応答・イラスト値

```json
{
  "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/Bash

```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: text/plain' \
  --data '{"source":"google_search","query":"vector databases"}'
```

#### 例応答・イラスト値

```text
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

応答をテキストとして読みます: メタデータを最初に、Markdown コンテンツに従って、.

#### 要求 · cURL/Bash

```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: text/plain' \
  --header 'X-Respond-With: markdown' \
  --data '{"source":"google_search","query":"vector databases"}'
```

#### 例応答・イラスト値

```text
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\.
```


- [API認証](https://flashdata.dev/ja/docs/guides/headers-and-authentication/reference.md)
- [Google Search応答フィールド](https://flashdata.dev/ja/docs/sources/google_search/reference.md#response)

<a id="supported-endpoints"></a>

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

同じルールは、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} | ジョブステータス | 無視される — 結果のコンテンツはここにありません |


<a id="completed-results"></a>

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

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

| リクエスト形式 | 結果の応答 |
| --- | --- |
| オリジナルJSON | 302 は、位置の署名されたストレージ URL と。 それをフェッチ URL 別々に、なし X-API-Key. 保存した結果は、gzip-compressed です。 |
| テキストまたはMarkdownオプションのいずれかをプレーする | 200 は、整形されたボディを直接応答で指定します。 |

### リトリーブ Markdown 内側に JSON · cURL / Bash

```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'
```

- [オリジナル・リトリーブ JSON · Python とりあえず cURL](https://flashdata.dev/ja/docs/reference/realtime-and-async/reference.md#results)

<a id="errors-and-scope"></a>

## フォーマットエラー

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 はサポートされていません。 |

- [エラーとステータスコード](https://flashdata.dev/ja/docs/errors/reference.md)

<a id="negotiation"></a>

## Accept ヘッダーの詳細

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

### テキストを優先し、JSONを割り当てて下さい

```http
Accept: text/plain; charset=utf-8, application/json;q=0.8
```

