Salta al contenuto
IT
Ottieni la chiave API
Sfoglia la documentazione

Per iniziare

Avvio rapido Python SDK

Installare il Python SDK e stampare i risultati della ricerca con alcune linee di codice. Include esempi sincroni e asincroni.

  1. Installare la SDK

    Richiede Python 3.10+. Eseguire questi comandi nella directory del progetto. Già utilizzando un ambiente virtuale? Installare flashdata==1.1.0 con il pitone di quell'ambiente -m pip invece.

    Installa
    python3 -m venv .venv
    .venv/bin/python -m pip install "flashdata==1.1.0"
  2. Autentico

    Creare una chiave API con il permesso di ricerca Google o riutilizzare una chiave autorizzata. Impostarlo in questo terminale utilizzando il prompt nascosto qui sotto.

    Salta il prompt se FLASHDATA_API_KEY è già impostato. Questi esempi leggono direttamente la variabile; non caricano i file .env.

    Segnale chiave nascosta · 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. Esegui una ricerca

    Salvare questo come quickstart.py, quindi eseguirlo con lo stesso ambiente virtuale. Fa una richiesta di ricerca Google per un massimo di cinque risultati e stampe titoli, URLs e crediti utilizzati.

    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"])
    Esegui
    .venv/bin/python quickstart.py
  4. Verifica il risultato

    Lo script esce normalmente dopo il controllo dello stato. I titoli di origine previsti e URLs seguiti da Crediti utilizzati. Una lista organica vuota è una risposta valida; i risultati variano con la tua richiesta.

    Esempio di output
    Battery recycling research https://example.org/recycling
    Credits used: 0.02
    results[].organic[]
    Google Cerca successi: titolo, link e snippet. Altre fonti hanno diversi campi di risultato.
    usage.credits
    Costo di questa richiesta. Fino a cinque risultati qui sono una richiesta di ricerca.

Prova un'altra fonte di dati

Ogni scheda è uno script completo. Sostituire quickstart.py con un esempio ed eseguirlo con il comando dal passo 3. Ogni esecuzione presenta una nuova richiesta; la chiave ha bisogno del permesso di origine mostrato.

Richiede google_news. Stampa i titoli dell'articolo e i link di origine da 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"))

Che cosa supporta Python SDK

google / youtube
Google Cerca, Notizie, Immagini, Shopping, Video e Luoghi; YouTube scoperta, metadati, didascalie, trascrizioni e dati del canale.
youtube.download
Invia un lavoro di consegna audio o video al tuo cloud storage. Richiede il permesso youtube_download e la configurazione di archiviazione; segui l'esempio di download completo qui sotto.
jobs / bulk
Salvare il lavoro accettato ID, attendere il completamento e recuperare i risultati. Utilizzare la rinfusa per i dataset video-ID più grandi e riprendere i lavori esistenti dopo un riavvio.
account
Leggi l'accesso, l'equilibrio, i prezzi, i limiti e l'utilizzo prima del lavoro ricorrente. Riutilizzare una chiave autorizzata dal tuo ambiente o negozio segreto.
respond_with / accept
Utilizzare respond_with="markdown" per Markdown in risposta["content"], o accettare="text/plain" per una stringa. I dizionari JSON sono i valori predefiniti.

Utilizzare la sincronizzazione

Sostituire quickstart.py con questa versione e utilizzare lo stesso comando run. AsyncFlashData espone le stesse risorse con attesa. Questo aspetta ancora una risposta di ricerca in tempo reale; mode="async" presenta invece un lavoro di sfondo lato server.

In Jupyter o un'applicazione con un ciclo di eventi in esecuzione, l'uso attendere principale() invece di asyncio.run(main()). Riutilizzare il cliente all'interno di quel ciclo di eventi.

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())

Prossimo passo

Se un passo fallisce

ModuleNotFoundError
Installare ed eseguire con lo stesso interprete: .venv/bin/python -m pip mostra i dati flash (Windows: .\.venv\Scripts\python.exe -m pip mostra i dati flash). Non nominare il tuo script flashdata.py.
KeyError: FLASHDATA_API_KEY / 401
Impostare un tasto API attivo nello stesso terminale. Un file .env da solo non è caricato da questo esempio. Utilizzare una chiave API, non un token MCP OAuth.
403
Concedere il permesso di origine richiesto dall'esempio a questa chiave.
402
Controllare Billing per i crediti disponibili. Se l'accesso al prova è esaurito, richiedere la connessione per utilizzare il saldo del tuo account.
429 / APIError
Ispezionare error.retry_after e ridurre il tasso di richiesta. La SDK invia ogni richiesta una volta e non si riprova automaticamente.
SubmissionUnknownError
Una presentazione timed-out può già essere accettata. Controllare History prima di ripeterlo; riutilizzare un lavoro salvato ID quando disponibile.
asyncio.run() / running event loop
L'uso attende il main() in un notebook o in un loop di eventi esistente. Tenere asyncio.run(main())) per uno script standalone.