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

Primeiros passos

Python SDK Quickstart

Instale o Python SDK e imprima resultados de busca com algumas linhas de código. Inclui exemplos síncronos e assincios.

  1. Instale o SDK

    Requer Python 3.10+. Execute esses comandos no diretório do seu projeto. Já está usando um ambiente virtual? Instale os dados flash==1.1.0 com o python do ambiente -m pip em vez disso.

    Instalar
    python3 -m venv .venv
    .venv/bin/python -m pip install "flashdata==1.1.0"
  2. Autenticação

    Crie uma chave API com permissão Google Search, ou reutilize uma chave autorizada. Coloque-o neste terminal usando o prompt escondido abaixo.

    Pule o prompt se FLASHDATA_API_KEY já está definido. Estes exemplos lêem a variável diretamente, eles não carregam arquivos env.

    Chave escondida pronta. Bash
    # 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
  3. Faça uma pesquisa

    Guarde isso como quickstart.py, então execute com o mesmo ambiente virtual. Faz um pedido Google Search para até cinco resultados e imprime títulos, URLs e créditos usados.

    quickstart.py
    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)
        for page in response["results"]:
            for hit in page.get("organic", []):
                print(hit["title"], hit["link"])
        print("Credits used:", response["usage"]["credits"])
    Executar
    .venv/bin/python quickstart.py
  4. Confira o resultado

    O script sai normalmente depois de verificar o status. Espero títulos de origem e URLs seguido de créditos usados. Uma lista orgânica vazia é uma resposta válida, os resultados variam com sua consulta.

    Exemplo de saída
    Battery recycling research https://example.org/recycling
    Credits used: 0.02
    results[].organic[]
    Google Search: título, link e trecho. Outras fontes têm diferentes campos de resultados.
    usage.credits
    Custo deste pedido. Até cinco resultados aqui são um pedido de busca.

Tente outra fonte de dados

Cada guia é um roteiro completo. Substitua quickstart.py por um exemplo e execute com o comando do passo 3. Cada corrida envia um novo pedido, a chave precisa da permissão da fonte mostrada.

Requer google_news. Imprime títulos de artigos e links de origem do results[].news[].

quickstart.py
import os
from flashdata import FlashData

with FlashData(api_key=os.environ["FLASHDATA_API_KEY"]) as client:
    response = client.google.news("battery recycling", num=5)
    if response["status"] != "done":
        raise RuntimeError(response)
    for page in response["results"]:
        for article in page.get("news", []):
            print(article.get("title"), article.get("link"))

O que o Python SDK suporta

google / youtube
Google Search, Notícias, Imagens, Compras, Vídeos e Locais; Descoberta YouTube, metadados, legendas, transcrições e dados do canal.
youtube.download
Envie um trabalho de entrega de áudio ou vídeo para o seu armazenamento na nuvem. Requer permissão youtube_download e configuração de armazenamento; siga o exemplo completo de download abaixo.
jobs / bulk
Salve o trabalho aceito ID, espere pela conclusão e recupere os resultados. Use o volume para maiores conjuntos de dados de vídeo ID e retome trabalhos existentes após uma reinicialização.
account
Leia acesso, equilíbrio, preços, limites e uso antes do trabalho recorrente. Reutilize uma chave autorizada do seu ambiente ou loja secreta.
respond_with / accept
Use respond_with="markdown" para Markdown em resposta."content"# Ou aceitar #"text/plain" Por uma corda. Dicionários JSON são o padrão.

Use assíncio

Substitua quickstart.py por esta versão e use o mesmo comando de execução. AsyncFlashData expõe os mesmos recursos com espera. Isso ainda espera por uma resposta de busca em tempo real, mode="async" envia uma tarefa de background do lado do servidor.

Em Jupyter ou uma aplicação com um loop de eventos em execução, use waiting main() em vez de asyncio.run(main()). Reutilize o cliente dentro do loop do evento.

quickstart.py
import asyncio
import os
from flashdata import AsyncFlashData

async def main():
    async with AsyncFlashData(api_key=os.environ["FLASHDATA_API_KEY"]) as client:
        response = await client.google.search("battery recycling research", num=5)
        if response["status"] != "done":
            raise RuntimeError(response)
        for page in response["results"]:
            for hit in page.get("organic", []):
                print(hit["title"], hit["link"])
        print("Credits used:", response["usage"]["credits"])

asyncio.run(main())

Próximos passos

Se um passo falhar

ModuleNotFoundError
Instale e execute com o mesmo intérprete: .venv/bin/python -m pip mostrar flashdata (Windows:.\.venv\Scripts\python.exe -m pip mostrar flashdata). Não nomeie seu script flashdata.py.
KeyError: FLASHDATA_API_KEY / 401
Defina uma chave API ativa no mesmo terminal. Um arquivo Env sozinho não é carregado por este exemplo. Use uma chave API, não um símbolo MCP OAuth.
403
Conceda a permissão de origem exigida pelo exemplo para esta chave.
402
Verifique Billing para os créditos disponíveis. Se o acesso ao teste estiver esgotado, reclame a conexão para usar o saldo da conta.
429 / APIError
Inspecione error.retry_after e reduza a taxa de solicitação. O SDK envia cada pedido uma vez e não tenta novamente automaticamente.
SubmissionUnknownError
Uma submissão cronometrada já pode ser aceita. Verifique History antes de repeti-lo, reutilize um trabalho salvo ID quando disponível.
asyncio.run() / running event loop
Use o main() em um notebook ou loop de eventos existentes. Mantenha asyncio.run(main()) para um script autônomo.