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

Primeiros passos

API start rápido

Chame Google Search e YouTube APIs diretamente sobre HTTP. Envie um pedido e leia a resposta JSON, nenhum SDK é necessário.

  1. 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_KEY
  2. Faç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 / cURL
    curl --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
      }
    }'
  3. Confira 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.

cURL
--dump-header response-headers.txt --output result.json

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

verificações grátis. Bash
(
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
)
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.