# FlashData API de Google Search

Recuperar resultados orgánicos, preguntas relacionadas y resultados ricos de Google Buscar como JSON estructurado. Filtrar por país, idioma y ubicación.

Referencia canónica: https://flashdata.dev/es/docs/sources/google_search
Reviewed: 2026-10-23

Punto final: POST https://data.flashdata.dev/v1/queries/realtime
Autenticación: X-API-Key: YOUR_API_KEY
Modos: [Tiempo real](https://flashdata.dev/es/docs/reference/realtime-and-async/reference.md#realtime) · [Asíncrono](https://flashdata.dev/es/docs/reference/realtime-and-async/reference.md#async) · [Batch](https://flashdata.dev/es/docs/reference/batch-and-bulk/reference.md#batch)

Permiso de origen obligatorio: google_search

Reemplace YOUR_API_KEY con una tecla API que tiene este permiso de origen y créditos disponibles. Ejecute solicitudes en su servidor o host de agente.

[Configuración de autenticación](https://flashdata.dev/es/docs/guides/headers-and-authentication/reference.md)

[Elija y refina una búsqueda de Google](https://flashdata.dev/es/docs/guides/google-search-guide/reference.md)

<a id="quickstart"></a>

## Enviar solicitud

### Python

```bash
python3 -m pip install requests
```

```python
import json

import requests

api_key = "YOUR_API_KEY"
payload = {
    "source": "google_search",
    "query": "openai",
    "params": {
        "gl": "us",
        "hl": "en",
        "num": 10,
        "page": 1,
    },
}

response = requests.post(
    "https://data.flashdata.dev/v1/queries/realtime",
    headers={"X-API-Key": api_key},
    json=payload,
    timeout=120,
)
response.raise_for_status()
print(json.dumps(response.json(), ensure_ascii=False, indent=2))
```

### Bash / cURL

```bash
api_key="YOUR_API_KEY"
curl --fail-with-body --max-time 120 --request POST "https://data.flashdata.dev/v1/queries/realtime" \
  --header "Content-Type: application/json" \
  --header "X-API-Key: $api_key" \
  --data-binary @- <<'FLASHDATA_JSON'
{
  "source": "google_search",
  "query": "openai",
  "params": {
    "gl": "us",
    "hl": "en",
    "num": 10,
    "page": 1
  }
}
FLASHDATA_JSON
```

<a id="parameters"></a>

## Parámetros

<a id="parameters-group-0"></a>

### Solicitud de cuerpo

| Parámetro | Tipo | Obligatorio | Default | Descripción |
| --- | --- | --- | --- | --- |
| <a id="parameter-source"></a> source | string | Sí. | — | Listo para google_search.  |
| <a id="parameter-query"></a> query | string | Sí. | Sin definir | Soporta a los operadores de búsqueda Google como el sitio: e intitle:. Longitud mínima: 1. Longitud máxima: 2000. |
| <a id="parameter-params"></a> params | object | No. | {} | Ajustes para esta solicitud.  |
| <a id="parameter-callback_url"></a> callback_url | string · nullable | No. | Sin definir | Solo Async y lote. Public HTTPS completion URL en port 443, hasta caracteres 2,048. No hay credenciales de usuario o fragmento URL. Omitir, usar null o una cadena vacía para ninguna notificación. En un lote, establece esto en cada consulta, fuera de los params.  |

<a id="parameters-group-1"></a>

### País, idioma y ubicación

| Parámetro | Tipo | Obligatorio | Default | Descripción |
| --- | --- | --- | --- | --- |
| <a id="parameter-params-gl"></a> params.gl | string | No. | Sin definir | Código de dos letras, como nosotros, gb, de o sg. Establecer explícitamente para seleccionar un país. Longitud mínima: 2. Longitud máxima: 2. Patrón: ^[A-Za-z]{2}$ |
| <a id="parameter-params-hl"></a> params.hl | string | No. | Sin definir | Google idioma de interfaz. Establecer explícitamente para seleccionar un idioma. Longitud mínima: 1. Longitud máxima: 35. Patrón: ^[A-Za-z0-9-]+$ |
| <a id="parameter-params-location"></a> params.location | string | No. | Sin definir | Solicitud de ubicación de búsqueda, preferiblemente una ciudad, como "London, England, United Kingdom". La disponibilidad depende del tipo de búsqueda. Longitud mínima: 1. Longitud máxima: 200. |

<a id="parameters-group-2"></a>

### Pagination

| Parámetro | Tipo | Obligatorio | Default | Descripción |
| --- | --- | --- | --- | --- |
| <a id="parameter-params-num"></a> params.num | integer | No. | Sin definir | Cuento de resultado solicitado. FlashData no añade un defecto fijo cuando se omitió. El recuento devuelto puede diferir por tipo de consulta y búsqueda. Mínimo: 1. Maximum: 100. |
| <a id="parameter-params-page"></a> params.page | integer | No. | Sin definir | Página de resultado solicitada. Establecer explícitamente. Cada página es una solicitud API separada. Mínimo: 1. Maximum: 100. |

<a id="parameters-group-3"></a>

### Filtros de búsqueda

| Parámetro | Tipo | Obligatorio | Default | Descripción |
| --- | --- | --- | --- | --- |
| <a id="parameter-params-tbs"></a> params.tbs | string | No. | Sin definir | Solicitar filtros de búsqueda Google, como qdr:d para el día pasado o qdr:w para la semana pasada. Disponibilidad depende del tipo de búsqueda. Longitud mínima: 1. Longitud máxima: 200. |
| <a id="parameter-params-autocorrect"></a> params.autocorrect | boolean | No. | Sin definir | Solicitar corrección de ortografía con verdadero o solicitarlo deshabilitado con falso. El comportamiento aplicado depende del tipo de búsqueda; omitir para usar el comportamiento de Google.  |

<a id="response"></a>

## Lea el resultado

Guardar la respuesta JSON exitosa como response.json. Guardar esto como read-response.py y ejecutar python read-response.py. Utiliza sólo la biblioteca estándar de Python y no hace ninguna nueva petición.

### read-response.py

```python
import json
from pathlib import Path

response = json.loads(Path("response.json").read_text(encoding="utf-8-sig"))
if response.get("status") not in ("done", "completed") or not isinstance(response.get("results"), list):
    raise SystemExit("Expected completed result JSON; inspect the response or job status.")
if not response["results"]:
    print("[]")
    raise SystemExit(0)
result = response["results"][0]

output = [
    {"title": item.get("title"), "url": item.get("link"), "snippet": item.get("snippet")}
    for item in result.get("organic", [])
]
print(json.dumps(output, ensure_ascii=False, indent=2))
```

## Ejemplo de respuesta

Ejemplo registrado; campos y conteos dependen de la fuente y la entrada solicitada.
```json
{
  "source": "google_search",
  "status": "done",
  "results": [
    {
      "searchParameters": {
        "q": "openai",
        "gl": "us",
        "hl": "en",
        "type": "search",
        "num": 10,
        "page": 1,
        "engine": "google"
      },
      "organic": [
        {
          "title": "OpenAI | Research & Deployment",
          "link": "https://openai.com/",
          "snippet": "We believe our research will eventually lead to artificial general intelligence, a system that can solve human-level problems.",
          "position": 1
        },
        {
          "title": "OpenAI",
          "link": "https://en.wikipedia.org/wiki/OpenAI",
          "snippet": "OpenAI is an American artificial intelligence (AI) public benefit corporation (PBC) headquartered in San Francisco. It develops proprietary generative AI models ...",
          "position": 2
        },
        {
          "title": "OpenAI",
          "link": "https://x.com/OpenAI",
          "snippet": "OpenAI's mission is to ensure that artificial general intelligence benefits all of humanity. can develop research, build financial models, and create ...",
          "position": 3
        },
        {
          "title": "OpenAI",
          "link": "https://www.linkedin.com/company/openai",
          "snippet": "OpenAI is an AI research and deployment company dedicated to ensuring that general-purpose artificial intelligence benefits all of humanity.",
          "position": 4
        },
        {
          "title": "r/OpenAI",
          "link": "https://www.reddit.com/r/OpenAI/",
          "snippet": "OpenAI is an AI research and deployment company. OpenAI&#39;s mission is to create safe and powerful AI that benefits all of humanity. OpenAI's ...",
          "position": 5
        }
      ],
      "peopleAlsoAsk": [
        {
          "question": "Is OpenAI created by Elon Musk?"
        },
        {
          "question": "Why are people leaving ChatGPT?"
        },
        {
          "question": "Is OpenAI the same as ChatGPT?"
        },
        {
          "question": "Why is OpenAI in trouble?"
        }
      ],
      "relatedSearches": [
        {
          "query": "OpenAI login"
        },
        {
          "query": "OpenAI chat"
        },
        {
          "query": "OpenAI ChatGPT"
        },
        {
          "query": "OpenAI - wikipedia"
        },
        {
          "query": "OpenAI API"
        },
        {
          "query": "OpenAI app"
        },
        {
          "query": "OpenAI download"
        },
        {
          "query": "OpenAI video"
        }
      ]
    }
  ],
  "usage": {
    "credits": 0.02
  },
  "created_at": "2026-09-16T07:41:40.043Z"
}
```

## Campos de respuesta

| Campo | Tipo | Descripción |
| --- | --- | --- |
| source | string | La fuente API solicitada. |
| status | string | hecho cuando la solicitud en tiempo real tiene éxito. |
| created_at | string | Tiempo de creación de respuestas en formato ISO 8601. |
| usage.credits | number | Créditos cobrados para la solicitud, basado en su plan. |
| results[0].searchParameters | object | Los ajustes de búsqueda reportados por Google, con la consulta registrada como q. Los ajustes devueltos pueden diferir de los valores solicitados. |
| results[0].organic | array | Resultados orgánicos con título, enlace, snippet y posición, además de campos adicionales cuando esté disponible. |
| results[0].peopleAlsoAsk | array · optional | Preguntas relacionadas, con respuestas y enlaces de fuente cuando esté disponible. |
| results[0].relatedSearches | array · optional | Términos de búsqueda relacionados, cada uno con un campo de consulta. |
| results[0].knowledgeGraph | object · optional | Información de la Entidad del Panel de Conocimiento. |
| results[0].answerBox | object · optional | Respuesta destacada. Los campos varían con el tipo de respuesta. |

- Los campos disponibles dependen del tipo de consulta y búsqueda. Los campos opcionales pueden estar ausentes, y pueden ser devueltos campos adicionales.
- El número de artículos devueltos y searchParameters.num pueden diferir de params.num. Utilice el array devuelto para determinar el recuento de resultados real.

## Formatos de respuesta

Las respuestas utilizan JSON por defecto. Elige otro formato con estos encabezados opcionales.

- Accept: application/json (por defecto) o text/plain. El texto sencillo presenta los mismos campos en un diseño legible e indentado.
- X-Respond-With: markdown. Deja unset para campos originales. Markdown funciona con formato de respuesta.

Markdown está disponible para consultas en tiempo real y resultados completados.

Los campos de abajo describen la respuesta JSON predeterminada.

[Ejemplos de formularios de solicitud y respuesta](https://flashdata.dev/es/docs/guides/response-formats/reference.md#headers)

<a id="job-lifecycle"></a>

<a id="async-batch"></a>

## Conceptos básicos de la API

El constructor de solicitudes y los ejemplos anteriores utilizan los parámetros de esta fuente. Use los ejemplos Python y cURL a continuación para la presentación compartida, estado y pasos de resultado. Un cuerpo Batch es un objeto JSON que contiene consultas; cada artículo devuelve su propio trabajo ID.

- [Solicitud y recepción de Async](https://flashdata.dev/es/docs/reference/realtime-and-async/reference.md#async)

<a id="job-status"></a>

- [Consultar el estado del trabajo](https://flashdata.dev/es/docs/reference/realtime-and-async/reference.md#status)

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

- [Recuperar los resultados](https://flashdata.dev/es/docs/reference/realtime-and-async/reference.md#results)
- [Batch JSON peticiones](https://flashdata.dev/es/docs/reference/batch-and-bulk/reference.md#batch)
- [Cliente OpenAPI](https://flashdata.dev/docs/openapi.json)

<a id="webhooks"></a>

<a id="callbacks"></a>

## Notificaciones de terminación

- [Recibir y verificar los juegos web de terminación](https://flashdata.dev/es/docs/guides/async-batch/reference.md#webhooks)

<a id="troubleshooting"></a>

## Solución de problemas

- [Errores y códigos de estado](https://flashdata.dev/es/docs/errors/reference.md#status-codes)
- [Cuándo volver a entrar](https://flashdata.dev/es/docs/errors/reference.md#retries)

## API relacionadas

- [Google Imágenes API](https://flashdata.dev/es/docs/sources/google_images/reference.md)
- [Google Noticias API](https://flashdata.dev/es/docs/sources/google_news/reference.md)
