# Antwortformate

Wählen Sie strukturiertes JSON für Ihre Anwendung oder Markdown-Inhalte für einen AI-Agenten. Kontrollieren Sie die Antwort mit zwei Headern.

Kanonische Referenz: https://flashdata.dev/de/docs/guides/response-formats
Test: 2026-11-04 von FlashData

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

## Wählen Sie ein Format

JSON mit ursprünglichen Ergebnisfeldern ist der Standard. Accept wählt JSON oder Klartext; X-Respond-With: Markdown konvertiert den Ergebnisinhalt in Markdown. Ihre Anfrage Körper bleibt JSON.

| Antwort | Accept | X-Respond-With | Verwendung für |
| --- | --- | --- | --- |
| JSON | application/json | Auslassen | Paring-Felder im Code · Standard |
| JSON + Markdown | application/json | markdown | Agent Kontext mit strukturierten Metadaten |
| Klartext | text/plain | Auslassen | Lesen von Originalfeldern in einem Terminal |
| Text + Markdown | text/plain | markdown | Metadaten und Markdown zusammen lesen |


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

## Anfrage- und Antwortbeispiele

Diese Registerkarten zeigen das gleiche Google Search in jedem Format. Verwenden Sie Bash und cURL 7.76+, wobei FLASHDATA_API_KEY auf einen Schlüssel gesetzt ist, der google_search ermöglicht. Durch Ausführen eines Befehls wird eine abrechenbare Suche gesendet.

### JSON

Ausfall. Parse das Ergebnis-Array; die Felder im Inneren hängen von der Quelle ab.

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

#### Beispielantwort · Veranschaulichungswerte

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

Lesen Sie Inhalte als Markdown-String. Es ersetzt Ergebnisse; Quelle, Status und Nutzung bleiben als JSON-Felder verfügbar.

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

#### Beispielantwort · Veranschaulichungswerte

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


### Klartext

Lesen Sie die Antwort als Text. Es enthält die ursprünglichen Felder in einem eingerückten Layout, nicht ein JSON-Dokument.

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

#### Beispielantwort · Veranschaulichungswerte

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


### Text + Markdown

Lesen Sie die Antwort als text: Metadaten zuerst, gefolgt von Markdown Inhalt.

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

#### Beispielantwort · Veranschaulichungswerte

```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-Authentifizierung](https://flashdata.dev/de/docs/guides/headers-and-authentication/reference.md)
- [Google Search Antwortfelder](https://flashdata.dev/de/docs/sources/google_search/reference.md#response)

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

## Unterstützte Endpunkte

Die gleichen Regeln gelten für Google Search und YouTube Abfragequellen. Für YouTube Download formatieren sie den Lieferdatensatz, nicht die Video- oder Audiobytes. Konto-APIs, Bulk-Manifeste und NDJSON-Teile, Rückrufe und MCP-Antworten verwenden ihre eigenen Formate.

| Endpunkt | JSON / Klartext | Markdown-Gehalt |
| --- | --- | --- |
| POST /v1/queries/realtime | Unterstützt | Unterstützt |
| GET /v2/jobs/{id}/results | Unterstützt | Unterstützt |
| POST /v1/queries | Eingangsbestätigung | Ignoriert - Wählen Sie es beim Lesen von Ergebnissen |
| POST /v1/queries/batch | Eingangsbestätigung | Ignoriert - Wählen Sie es beim Lesen von Ergebnissen |
| GET /v2/jobs/{id} | Stellenstatus | Ignoriert — kein Ergebnis Inhalt hier |


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

## Formatieren Sie ein abgeschlossenes Jobergebnis

Legen Sie die Header beim Lesen des Ergebnisses fest, auch wenn Sie sie bei der Einreichung festlegen. Setzen Sie JOB_ID auf einen abgeschlossenen Job, auf den Sie zugreifen können. Dieser GET liest vorhandene Ergebnisse, ohne eine weitere Abfrage einzureichen.

| Angefordertes Format | Ergebnisantwort |
| --- | --- |
| Original JSON | 302 mit signiertem Speicher URL in Location. Holen Sie sich URL separat, ohne X-API-Key. Gespeicherte Ergebnisse können gzip-komprimiert werden. |
| Klartext oder entweder Markdown Option | 200 mit dem formatierten Körper direkt in der Antwort. |

### Markdown innerhalb von 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'
```

- [Abrufen des Originals JSON · Python und cURL](https://flashdata.dev/de/docs/reference/realtime-and-async/reference.md#results)

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

## Formatfehler

API Fehler bleiben JSON oder application/problem+json, auch wenn Sie Klartext anfordern. Überprüfen Sie den HTTP-Status, bevor Sie das Erfolgsformat analysieren.

| Status/Code | Fixpunkt |
| --- | --- |
| 400 · unsupported_representation | Verwenden Sie X-Respond-With: Markdown oder Weglassen des Headers. Werte wie json oder text werden nicht unterstützt. |
| 406 · not_acceptable | Accept verwenden: application/json oder text/plain. text/markdown und application/xml werden nicht unterstützt. |

- [Fehler und Statuscodes](https://flashdata.dev/de/docs/errors/reference.md)

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

## Accept Header Details

Lassen Sie Accept aus oder senden Sie */*, um JSON zu erhalten. Antworten verwenden UTF-8. Medienbereiche und q-Gewichte werden unterstützt; ein nicht unterstütztes Zeichenwerk gibt 406 zurück, es sei denn, ein anderer akzeptabler Bereich stimmt überein. Content-Type: application/json beschreibt den Request Body, nicht die Antwort.

### Text vorziehen, JSON zulassen

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

