# Inicio rápido

Haz tu primera búsqueda en Google y obtén resultados estructurados para tu aplicación o agente de IA.

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

<a id="agent"></a>

## Empieza con tu agente de IA

Envía estas instrucciones a un agente con acceso al terminal. Configurará FlashData y hará una búsqueda.

### Instrucciones de configuración y primera tarea

```text
Lee https://flashdata.dev/auth.md y sigue las instrucciones de configuración de FlashData para este entorno. Reutiliza el acceso existente; si no existe, inicia una sola prueba si cumples los requisitos. Busca en Google "battery recycling research" y devuelve hasta cinco resultados. Incluye los títulos, las URLs y los créditos realmente consumidos. Guarda las credenciales en un almacén protegido, nunca en el chat. Si el acceso está bloqueado, indica el siguiente paso en lugar de crear otra prueba.
```

- [Configuración de MCP](https://flashdata.dev/es/docs/integrations/mcp-clients/reference.md)
- [Skills para agentes](https://flashdata.dev/es/docs/guides/agent-skill/reference.md)

<a id="application"></a>

## Haz tu primera llamada a la API

¿Prefieres escribir el código? Sigue estos tres pasos en tu terminal.


<a id="api-key"></a>

### Obtén una clave API

Crea una cuenta, verifica tu correo y crea una clave con permiso de Google Search. Si ya tienes una clave con ese permiso, reutilízala.

Ejecuta este comando en el terminal y pega la clave cuando se solicite; no se mostrará en pantalla. Omite este paso si FLASHDATA_API_KEY ya está definida.

#### Bash

##### Configura tu clave

```bash
# Bash: paste the key into a hidden prompt, not into this command.
read -r -s -p "FlashData API key: " FLASHDATA_API_KEY
printf '\n'
export FLASHDATA_API_KEY
```


#### PowerShell 7

##### Configura tu clave

```powershell
# PowerShell 7: paste the key into a hidden prompt.
$flashdataSecureKey = Read-Host "FlashData API key" -AsSecureString
$env:FLASHDATA_API_KEY = [System.Net.NetworkCredential]::new("", $flashdataSecureKey).Password
Remove-Variable flashdataSecureKey
```


- [Crear una cuenta](https://flashdata.dev/signup)
- [Abrir Claves API](https://flashdata.dev/app/api-keys)

<a id="request"></a>

### Haz una búsqueda

Elige un lenguaje y ejecuta el ejemplo en el mismo terminal. Cada ejecución hace una búsqueda.

#### Python

Python 3.10+ · Guarda el ejemplo como quickstart.py.

##### Instalar

```bash
python -m pip install "flashdata==1.1.0"
```

##### quickstart.py

```python
import json
import os
from flashdata import FlashData

with FlashData(api_key=os.environ["FLASHDATA_API_KEY"]) as client:
    response = client.google.search("battery recycling research", num=5)
    if response["status"] != "done":
        raise RuntimeError(response)
    print(json.dumps(response, indent=2))
```

##### Ejecutar

```bash
python quickstart.py
```


#### TypeScript

Node.js 22.18+ · Empieza en una carpeta vacía y guarda el archivo quickstart.mts.

##### Preparar el proyecto

```bash
npm init -y
npm install --save-exact @flashdata-dev/sdk@1.1.0
```

##### quickstart.mts

```typescript
import { FlashData } from '@flashdata-dev/sdk';

const apiKey = process.env.FLASHDATA_API_KEY;
if (!apiKey) throw new Error('Set FLASHDATA_API_KEY first.');
const client = new FlashData({ apiKey });
const response = await client.google.search({
  query: 'battery recycling research', num: 5,
});
if (response.status !== 'done') throw new Error(JSON.stringify(response));
console.log(JSON.stringify(response, null, 2));
```

##### Ejecutar

```bash
node quickstart.mts
```


#### JavaScript

Node.js 22+ · Empieza en una carpeta vacía y guarda el archivo quickstart.mjs.

##### Preparar el proyecto

```bash
npm init -y
npm install --save-exact @flashdata-dev/sdk@1.1.0
```

##### quickstart.mjs

```javascript
import { FlashData } from '@flashdata-dev/sdk';

const apiKey = process.env.FLASHDATA_API_KEY;
if (!apiKey) throw new Error('Set FLASHDATA_API_KEY first.');
const client = new FlashData({ apiKey });
const response = await client.google.search({
  query: 'battery recycling research', num: 5,
});
if (response.status !== 'done') throw new Error(JSON.stringify(response));
console.log(JSON.stringify(response, null, 2));
```

##### Ejecutar

```bash
node quickstart.mjs
```


#### Go

Go 1.25+ · Empieza en una carpeta vacía y guarda el archivo main.go. Omite go mod init si ya estás en un módulo existente.

##### Preparar el proyecto

```bash
go mod init example.com/flashdata-quickstart
go get github.com/flashdatadev/flashdata-go@v1.1.0
```

##### main.go

```go
package main

import (
    "context"
    "encoding/json"
    "log"
    "os"
    "time"

    flashdata "github.com/flashdatadev/flashdata-go"
)

func main() {
    key := os.Getenv("FLASHDATA_API_KEY")
    if key == "" {
        log.Fatal("Set FLASHDATA_API_KEY through your server's secret manager.")
    }
    client, err := flashdata.New(flashdata.Options{APIKey: key})
    if err != nil {
        log.Fatal(err)
    }
    ctx, cancel := context.WithTimeout(context.Background(), 2*time.Minute)
    defer cancel()
    result, err := client.Google.Search(ctx, flashdata.GoogleSearchInput{
        Query: "battery recycling research",
        Params: &flashdata.GoogleSearchParams{Num: flashdata.Ptr(int64(5))},
    })
    if err != nil {
        // Do not automatically resubmit an uncertain paid request.
        log.Fatal(err)
    }
    if err := json.NewEncoder(os.Stdout).Encode(result); err != nil {
        log.Fatal(err)
    }
    if result.Status != "done" {
        log.Fatalf("Search did not complete: %s", result.Status)
    }
}
```

##### Ejecutar

```bash
go run .
```


#### HTTP API

No necesitas un SDK. Ejecuta el comando de Bash / cURL 7.76+ o el de PowerShell 7.

##### Bash / cURL

```bash
curl --fail-with-body --silent --show-error \
  --request POST https://data.flashdata.dev/v1/queries/realtime \
  --header "X-API-Key: $FLASHDATA_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{"source":"google_search","query":"battery recycling research","params":{"num":5}}'
```

##### PowerShell 7

```powershell
$flashdataRequest = '{"source":"google_search","query":"battery recycling research","params":{"num":5}}'
$flashdataResult = Invoke-RestMethod -Method Post -Uri 'https://data.flashdata.dev/v1/queries/realtime' -Headers @{ 'X-API-Key' = $env:FLASHDATA_API_KEY } -ContentType 'application/json' -Body $flashdataRequest
$flashdataResult | ConvertTo-Json -Depth 20
```


- [Comprueba el resultado a continuación](https://flashdata.dev/es/docs/guides/quickstart/reference.md#result)

<a id="result"></a>

### Comprueba el resultado

Una respuesta correcta contiene status: done. Las fuentes están en results[].organic y los créditos cobrados, en usage.credits.

#### Ejemplo de respuesta abreviado

```json
{
  "status": "done",
  "results": [
    {
      "organic": [
        {
          "title": "Battery recycling research",
          "link": "https://example.org/recycling",
          "snippet": "An example search excerpt."
        }
      ]
    }
  ],
  "usage": {
    "credits": 0.02
  }
}
```

- [Mejorar la búsqueda](https://flashdata.dev/es/docs/guides/google-search-guide/reference.md)
- [Probar YouTube Data](https://flashdata.dev/es/docs/guides/youtube-data-guide/reference.md)
- [Configuración de la API y solución de problemas](https://flashdata.dev/es/docs/guides/http-quickstart/reference.md)

<a id="console"></a>

## Prueba la consola

1. Crea una cuenta o inicia sesión. Verifica tu correo y completa la configuración que indique la consola.
2. Abre Google Search, selecciona la fuente Google Search y el modo Realtime, e introduce battery recycling research. Despliega Additional parameters y establece Page size (num) en 5.
3. Comprueba la solicitud y los créditos disponibles antes de ejecutar la búsqueda una vez.
4. Revisa la respuesta y el consumo. Abre una de las fuentes para comprobar su contenido antes de citar información que no aparezca en el fragmento devuelto.

- [Crear una cuenta](https://flashdata.dev/signup)
- [Abrir Google Search](https://flashdata.dev/app/google-search)

<a id="next"></a>

## Sigue a partir de tu primer resultado

- [Buscar con filtros](https://flashdata.dev/es/docs/guides/google-search-guide/reference.md)
- [Explorar datos de YouTube](https://flashdata.dev/es/docs/guides/youtube-data-guide/reference.md)
- [Añadir búsqueda a una aplicación](https://flashdata.dev/es/docs/guides/search-in-an-app/reference.md)

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

## Si falla la primera solicitud

| Qué ocurre | Cómo resolverlo |
| --- | --- |
| Falta FLASHDATA_API_KEY | Define la clave en el mismo terminal o entorno que ejecuta el ejemplo. Estos fragmentos no cargan archivos .env automáticamente. |
| 401 / 403 | Comprueba que la clave o conexión esté activa y tenga el permiso google_search. |
| 402 | Consulta los créditos disponibles en Billing. Vincula una prueba existente cuando necesites acceso como titular de una cuenta. |
| 429 | Respeta Retry-After. Conserva la misma identidad y prueba de registro; no crees otra prueba. |
| Tiempo de espera agotado o envío sin confirmar | Comprueba la ejecución existente antes de reintentar. En la CLI, conserva el perfil y el identificador de ejecución. Con el SDK o la API, guarda cualquier identificador de trabajo o de solicitud recibido. |

