Saltar al contenido
ES
Obtener clave API
Explorar documentación

Primeros pasos

Inicio rápido

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

Empieza con tu agente de IA

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

Haz tu primera llamada a la API

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

  1. 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.

    Configura tu clave
    # 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
  2. Haz una búsqueda

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

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

    Instalar
    python -m pip install "flashdata==1.1.0"
    quickstart.py
    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
    python quickstart.py
  3. 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
    {
      "status": "done",
      "results": [
        {
          "organic": [
            {
              "title": "Battery recycling research",
              "link": "https://example.org/recycling",
              "snippet": "An example search excerpt."
            }
          ]
        }
      ],
      "usage": {
        "credits": 0.02
      }
    }

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.

Sigue a partir de tu primer resultado

Si falla la primera solicitud

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.