Pular para o conteúdo
PT
Obter chave API
Explorar documentação

Primeiros passos

Início rápido

Faça sua primeira pesquisa no Google e obtenha resultados estruturados para seu aplicativo ou agente de IA.

Comece com seu agente de IA

Envie estas instruções a um agente com acesso ao terminal. Ele configura o FlashData e faz uma pesquisa.

Faça sua primeira chamada à API

Prefere escrever o código? Siga estas três etapas no terminal.

  1. Obtenha uma chave de API

    Crie uma conta, verifique seu e-mail e crie uma chave com permissão para Google Search. Se você já tem uma chave, reutilize-a.

    Execute este comando no terminal e cole a chave na entrada oculta. Pule esta etapa se FLASHDATA_API_KEY já estiver definida.

    Definir sua chave
    # 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. Faça uma pesquisa

    Escolha uma linguagem e execute o exemplo no mesmo terminal. Cada execução faz uma pesquisa.

    Python 3.10+ · Salve o exemplo 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))
    Executar
    python quickstart.py
  3. Confira o resultado

    Uma resposta bem-sucedida contém status: done. As fontes estão em results[].organic, e os créditos cobrados, em usage.credits.

    Exemplo de resposta (resumido)
    {
      "status": "done",
      "results": [
        {
          "organic": [
            {
              "title": "Battery recycling research",
              "link": "https://example.org/recycling",
              "snippet": "An example search excerpt."
            }
          ]
        }
      ],
      "usage": {
        "credits": 0.02
      }
    }

Experimente o console

  1. Crie uma conta ou entre na sua. Verifique o e-mail e conclua as etapas de configuração exibidas no console.
  2. Abra Google Search, selecione a fonte Google Search e o modo Realtime e digite battery recycling research. Expanda Additional parameters e defina Page size (num) como 5.
  3. Confira a requisição exibida e os créditos disponíveis e execute a pesquisa uma vez.
  4. Examine a resposta e o uso. Abra uma fonte retornada para verificar seu conteúdo antes de citar informações além do trecho exibido.

Continue a partir do primeiro resultado

Se a primeira requisição falhar

FLASHDATA_API_KEY ausente
Defina a chave no mesmo terminal ou ambiente que executa o exemplo; estes trechos não carregam arquivos .env.
401 / 403
Confira se a chave ou conexão está ativa e tem a permissão google_search.
402
Confira os créditos disponíveis em Billing. Vincule o teste existente quando precisar de acesso do titular.
429
Respeite Retry-After. Mantenha a mesma identidade e prova de registro; não crie outro teste.
Tempo limite ou envio com resultado desconhecido
Verifique a execução existente antes de tentar novamente. Na CLI, mantenha o mesmo perfil e ID de execução; com SDK/API, preserve qualquer ID de trabalho ou requisição retornado.