Explorar documentação
Primeiros passos
Chame Google Search e YouTube APIs diretamente sobre HTTP. Envie um pedido e leia a resposta JSON, nenhum SDK é necessário.
Autenticação
Crie uma conta, verifique seu e-mail e crie uma chave com permissão Google Search. Você pode reutilizar uma chave existente.
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 um cliente e execute o exemplo no mesmo terminal. Cada um envia um pedido POST para https://data.flashdata.dev/v1/queries/realtime e imprime JSON. Autentique com X-API-Key; envie JSON com Content-Type: application/json.
cURL 7.76+ · Bash em Linux, macOS ou Git Bash.
Pesquisa · Bash / cURLcurl --fail-with-body --silent --show-error --max-time 70 \ --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+ · Colar este comando PowerShell nativo.
Pesquisa · PowerShell$flashdataRequest = '{"source":"google_search","query":"battery recycling research","params":{"num":5}}' $flashdataSearch = @{ Uri = 'https://data.flashdata.dev/v1/queries/realtime' Method = 'Post' Headers = @{ 'X-API-Key' = $env:FLASHDATA_API_KEY } ContentType = 'application/json' Body = $flashdataRequest TimeoutSec = 70 MaximumRedirection = 0 SkipHttpErrorCheck = $true ErrorAction = 'Stop' } $flashdataResponse = Invoke-WebRequest @flashdataSearch $flashdataResponse.Content if ($flashdataResponse.StatusCode -ge 400) { throw "HTTP $($flashdataResponse.StatusCode). Inspect the response above before retrying." }Node.js 22+ · Salve como search.mjs e execute localmente ou em seu servidor. Usa built-in fetch; nenhuma instalação npm.
search.mjsconst key = process.env.FLASHDATA_API_KEY; if (!key) throw new Error("Set FLASHDATA_API_KEY in this terminal."); let response; try { response = await fetch("https://data.flashdata.dev/v1/queries/realtime", { method: "POST", redirect: "error", signal: AbortSignal.timeout(70000), headers: { "X-API-Key": key, "Content-Type": "application/json" }, body: JSON.stringify({"source":"google_search","query":"battery recycling research","params":{"num":5}}), }); } catch { throw new Error("Request did not complete. Check History before resubmitting."); } const body = await response.text(); console.log(body); // Print the full response before checking its status. if (!response.ok) { const retryAfter = response.headers.get("retry-after"); throw new Error("HTTP " + response.status + ". See the response above." + (retryAfter ? " Retry-After: " + retryAfter : "")); } let result; try { result = JSON.parse(body); } catch { throw new Error("Expected JSON. Inspect the response above and the API URL."); } if (!result || result.error === true || result.status !== "done" || !Array.isArray(result.results)) { throw new Error("Query did not succeed. Inspect status and error in the response above."); }Corra! JavaScript!node search.mjsPython 3.10+ · Salvar como search.py. Usa apenas a biblioteca padrão, sem instalação pip. Use python3 ou py -3 se esse for o seu comando Python.
search.pyimport json import os import urllib.error import urllib.request key = os.environ.get("FLASHDATA_API_KEY") if not key: raise SystemExit("Set FLASHDATA_API_KEY in this terminal.") # Do not forward the API key to a redirect destination. class NoRedirect(urllib.request.HTTPRedirectHandler): def redirect_request(self, req, fp, code, msg, headers, newurl): return None request = urllib.request.Request( "https://data.flashdata.dev/v1/queries/realtime", data=json.dumps({"source":"google_search","query":"battery recycling research","params":{"num":5}}).encode("utf-8"), headers={"X-API-Key": key, "Content-Type": "application/json"}, method="POST", ) try: with urllib.request.build_opener(NoRedirect).open(request, timeout=70) as response: body = response.read().decode("utf-8") except urllib.error.HTTPError as error: print(error.read().decode("utf-8", errors="replace")) retry_after = error.headers.get("Retry-After") raise SystemExit("HTTP " + str(error.code) + ". See the response above." + (" Retry-After: " + retry_after if retry_after else "")) except (urllib.error.URLError, TimeoutError): raise SystemExit("Request did not complete. Check History before resubmitting.") print(body) # The run command saves this full response to result.json. try: result = json.loads(body) except json.JSONDecodeError: raise SystemExit("Expected JSON. Inspect the response above and the API URL.") if (not isinstance(result, dict) or result.get("error") is True or result.get("status") != "done" or not isinstance(result.get("results"), list)): raise SystemExit("Query did not succeed. Inspect status and error in the response above.")Corra! Python!python -X utf8 search.pyConfira o resultado
Confirmar sucesso HTTP e status: done. Leia títulos de origem, links e trechos em results[].organic, e a carga em usage.credits.
Um resultado vazio ou lista orgânica com status: done é um resultado vazio válido.
Resposta de exemplo{ "source": "google_search", "status": "done", "results": [ { "organic": [ { "title": "Battery recycling research", "link": "https://example.org/recycling", "snippet": "An example search excerpt." } ] } ], "usage": { "credits": 0.02 } }status- "done" confirma que a consulta terminou com sucesso.
results[0].organic[]- Resultados da pesquisa. Verifique se os resultados não estão vazios antes de indexá-los.
title / link / snippet- Título fonte, URL e trecho.
usage.credits- Créditos reais cobrados por esta consulta.
Guarde uma resposta para depuração
Para capturar o próximo pedido, adicione estas opções ao comando cURL acima. Inspecione os arquivos antes de decidir tentar novamente um pedido falhado.
--dump-header response-headers.txt --output result.jsonVerifique acesso e créditos
Estes pedidos GET ler identidade, equilíbrio e preços sem usar créditos de consulta. Espere HTTP 200 e verifique os campos abaixo antes de enviar trabalho pago.
A conta diz: https://api.flashdata.dev/v2. Pedidos de dados https://data.flashdata.dev/v1. Ambos usam X-API-Key; JSON POST também usa Content-Type: application/json.
(
for endpoint in 'identity' 'balance' 'pricing?source=google_search&request_count=1'; do
printf '\n%s\n' "$endpoint"
curl --fail-with-body --silent --show-error --max-time 20 \
--header "X-API-Key: $FLASHDATA_API_KEY" \
--write-out '\nHTTP %{http_code}\n' \
"https://api.flashdata.dev/v2/api-access/$endpoint" || exit
done
)try {
foreach ($flashdataPath in @('identity', 'balance', 'pricing?source=google_search&request_count=1')) {
Write-Host $flashdataPath
$flashdataRead = @{
Uri = "https://api.flashdata.dev/v2/api-access/$flashdataPath"
Headers = @{ 'X-API-Key' = $env:FLASHDATA_API_KEY }
TimeoutSec = 20
MaximumRedirection = 0
ErrorAction = 'Stop'
}
Invoke-RestMethod @flashdataRead | ConvertTo-Json -Depth 20
}
} catch {
throw
}identity- Confirme o accountId, access: "ready", escopos contendo "google_search", e qualquer expiresAt. accountType é "owned" para uma chave de proprietário ou "temporary" para uma chave de teste.
balance- Leia availableCredits. Todas as chaves desta conta usam o mesmo saldo.
pricing- Por preços.0# Confirmar que a fonte é google_search e disponível é true. Compare estimatedCredits para requestCount: 1 com availableCredits. Preços e saldos podem mudar antes da submissão.
Próximos passos
Se um passo falhar
Leia a resposta impressa em seu terminal. JavaScript e Python reportam erros HTTP e Retry-After para stderr. Cada exemplo se submete uma vez, não tenta automaticamente.
- Comando perdido ou não suportado
- Verifique a versão necessária no exemplo selecionado. Use PowerShell 7 em vez de Windows PowerShell 5.1, ou use Bash com cURL 7.76+. JavaScript precisa de Node 22+; Python precisa de 3.10+. Instale o tempo de execução perdido em sua página oficial de download, reabra o terminal e defina a chave novamente.
- Chave desaparecida / 401
- Coloque FLASHDATA_API_KEY neste processo e verifique a identidade novamente. Forneça a chave API ativa, sem um prefixo de portador. Se expirou ou foi revogado, use uma credencial autorizada, não cole em bate-papo.
- 403
- Verifique identity.scopes para google_search e acesso para pronto. Pedir a permissão do proprietário, mudar a fonte do pedido não permite acesso.
- 402
- Leia o balanço novamente e compare com o preço atual. O dono pode rever Billing. Um teste esgotado precisa de acesso do proprietário, criar um teste de substituição não é recuperação.
- 400 / 422
- Leia a mensagem de erro devolvida. Verifique o host de dados exato, o método POST, Content-Type e JSON. Use citações diretas e um params.num numérico, e então corrija o pedido rejeitado.
- 429
- Respeite o Retry-After se estiver presente, caso contrário, use um retrocesso limitado e reduza a concorrência. Não se apresse, crie novas chaves ou registre outro teste para ultrapassar o limite.
- HTTP 200 com status ou erro falhado
- Leia o erro no corpo e mantenha qualquer pedido ou trabalho ID. Não trate um corpo JSON como uma tarefa bem sucedida ou automaticamente reenviar.
- Resultados vazios
- Se o status for feito, a autenticação funcionou. Mantenha o resultado vazio ou tente uma consulta mais ampla como um novo pedido pago.
- Tempo limite, perda de conexão, 5xx ou HTML em vez de JSON
- Um POST pode ter sido aceito mesmo que sua resposta tenha sido perdida. Verifique History para a consulta original e guarde qualquer IDs retornado antes de decidir reenviar. Os verificações GET podem ser repetidos. Confirme que o URL usa data.flashdata.dev, não o host do site, e não desativa a verificação do TLS.