# Formatos de respuesta

Elige JSON estructurado para tu aplicación o contenido Markdown para un agente de IA. Configura la respuesta con dos cabeceras.

Referencia canónica: https://flashdata.dev/es/docs/guides/response-formats
Revisado: 2026-11-04 por FlashData

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

## Elija un formato

JSON con campos de resultado originales es el valor predeterminado. Accept selecciona JSON o texto plano; X-Respond-With: markdown convierte el contenido de resultado a Markdown. Su cuerpo de solicitud permanece JSON.

| Respuesta | Accept | X-Respond-With | Uso para |
| --- | --- | --- | --- |
| JSON | application/json | Omit | Campos de par en código · predeterminado |
| JSON + Markdown | application/json | markdown | Contexto de agente con metadatos estructurados |
| Texto de la traducción | text/plain | Omit | Leyendo campos originales en una terminal |
| Texto + Markdown | text/plain | markdown | Leer metadatos y Markdown juntos |


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

## Ejemplos de solicitud y respuesta

Estas pestañas muestran el mismo Google Buscar en cada formato. Utilice Bash y cURL 7.76+ con FLASHDATA_API_KEY configurado a una clave que permite google_search. Ejecutar un comando envía una búsqueda facturable.

### JSON

Default. Parse el array de resultados; los campos dentro de él dependen de la fuente.

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

#### Respuesta de ejemplo · Valores ilustrativos

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

Lea el contenido como una cadena Markdown. Reemplaza los resultados; fuente, estado y uso permanecen disponibles como campos JSON.

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

#### Respuesta de ejemplo · Valores ilustrativos

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


### Texto de la traducción

Lea la respuesta como texto. Contiene los campos originales en un diseño identificado, no un documento JSON.

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

#### Respuesta de ejemplo · Valores ilustrativos

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


### Texto + Markdown

Lea la respuesta como texto: metadatos primero, seguido por el contenido Markdown.

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

#### Respuesta de ejemplo · Valores ilustrativos

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


- [autenticación API](https://flashdata.dev/es/docs/guides/headers-and-authentication/reference.md)
- [Google Buscar campos de respuesta](https://flashdata.dev/es/docs/sources/google_search/reference.md#response)

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

## Puntos finales compatibles

Las mismas reglas se aplican a las fuentes de búsqueda Google y YouTube. Para YouTube Download, formatean el registro de entrega, no los bytes de vídeo o audio. APIs de cuenta, manifiestos Bulk y partes NDJSON, callbacks y respuestas MCP usan sus propios formatos.

| Punto final | JSON / texto plano | Contenido de Markdown |
| --- | --- | --- |
| POST /v1/queries/realtime | Apoyo | Apoyo |
| GET /v2/jobs/{id}/results | Apoyo | Apoyo |
| POST /v1/queries | Submission receipt | Ignorado — seleccione cuando lee resultados |
| POST /v1/queries/batch | Submission receipt | Ignorado — seleccione cuando lee resultados |
| GET /v2/jobs/{id} | Condición laboral | Ignorado: sin contenido de resultados aquí |


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

## Formato del resultado del trabajo completado

Establece los encabezados al leer el resultado, incluso si los establece en la presentación. Establece JOB_ID a un trabajo completado que puede acceder. Este GET lee los resultados existentes sin enviar otra consulta.

| Formato solicitado | Respuesta a los resultados |
| --- | --- |
| Original JSON | 302 con un almacenamiento firmado URL en Ubicación. Tome que URL por separado, sin X-API-Key. Los resultados almacenados pueden ser gzip-compressed. |
| Texto de la línea o la opción Markdown | 200 con el cuerpo formateado directamente en la respuesta. |

### Retrieve Markdown inside 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'
```

- [Recuperar JSON original · Python y cURL](https://flashdata.dev/es/docs/reference/realtime-and-async/reference.md#results)

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

## Errores de formato

Los errores de la API siguen en formato JSON o application/problem+json aunque solicites texto plano. Comprueba el estado HTTP antes de interpretar el formato de éxito.

| Estado / código | Arreglos |
| --- | --- |
| 400 · unsupported_representation | Utilice X-Respond-With: marcador o omitir el encabezado. Los valores como json o texto no son compatibles. |
| 406 · not_acceptable | Use Accept: application/json o text/plain. text/markdown y application/xml no son compatibles. |

- [Errores y códigos de estado](https://flashdata.dev/es/docs/errors/reference.md)

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

## Accept header details

Omit Accept o enviar */* para obtener JSON. Las respuestas utilizan UTF-8. Se admiten rangos de medios y pesos q; un charset no soportado devuelve 406 a menos que otro rango aceptable coincida. Content-Type: application/json describe el cuerpo de solicitud, no la respuesta.

### Texto preferido, permite JSON

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

