Explorar documentação
Primeiros passos
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.
Leia https://flashdata.dev/auth.md e siga as instruções de configuração do FlashData para este ambiente. Reutilize o acesso existente; se não houver acesso, inicie uma única avaliação se você atender aos requisitos. Pesquise no Google por "battery recycling research", com no máximo cinco resultados. Retorne os títulos das fontes, as URLs e os créditos efetivamente usados. Guarde as credenciais em armazenamento protegido, nunca no chat. Se o acesso estiver bloqueado, informe a próxima etapa em vez de criar outro teste.
Faça sua primeira chamada à API
Prefere escrever o código? Siga estas três etapas no terminal.
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_KEYDefinir sua chave# 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 flashdataSecureKeyFaç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.
Instalarpython -m pip install "flashdata==1.1.0"quickstart.pyimport 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))Executarpython quickstart.pyNode.js 22.18+ · Comece em uma pasta vazia e salve quickstart.mts.
Configurarnpm init -y npm install --save-exact @flashdata-dev/[email protected]quickstart.mtsimport { 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));Executarnode quickstart.mtsNode.js 22+ · Comece em uma pasta vazia e salve quickstart.mjs.
Configurarnpm init -y npm install --save-exact @flashdata-dev/[email protected]quickstart.mjsimport { 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));Executarnode quickstart.mjsGo 1.25+ · Comece em uma pasta vazia e salve main.go. Em um módulo existente, não execute go mod init.
Configurargo mod init example.com/flashdata-quickstart go get github.com/flashdatadev/[email protected]main.gopackage 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) } }Executargo run .Nenhum SDK é necessário. Execute o comando Bash / cURL 7.76+ ou o comando PowerShell 7.
Bash / cURLcurl --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$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 20Confira 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
- Crie uma conta ou entre na sua. Verifique o e-mail e conclua as etapas de configuração exibidas no console.
- 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.
- Confira a requisição exibida e os créditos disponíveis e execute a pesquisa uma vez.
- 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.