Sfoglia la documentazione
Per iniziare
Installare il Python SDK e stampare i risultati della ricerca con alcune linee di codice. Include esempi sincroni e asincroni.
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.
Installapython3 -m venv .venv .venv/bin/python -m pip install "flashdata==1.1.0"Installapy -3 -m venv .venv .\.venv\Scripts\python.exe -m pip install "flashdata==1.1.0"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_KEYSegnale chiave nascosta · PowerShell# 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 flashdataSecureKeyEsegui 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.pyimport 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.pyEsegui.\.venv\Scripts\python.exe quickstart.pyVerifica 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 outputBattery recycling research https://example.org/recycling Credits used: 0.02results[].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[].
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"))Richiede youtube_metadata. Stampa il titolo video, il canale e la durata in pochi secondi. Sostituire il video ID con uno che si desidera ispezionare.
import os
from flashdata import FlashData
with FlashData(api_key=os.environ["FLASHDATA_API_KEY"]) as client:
response = client.youtube.metadata("dQw4w9WgXcQ", include_formats=False)
if response["status"] != "done":
raise RuntimeError(response)
for video in response["results"]:
print(video.get("title"), video.get("channel"))
print("Seconds:", video.get("duration"))Richiede youtube_transcript. Stampa una trascrizione automatica inglese esistente da results[].fullText. Il video deve avere quella traccia; questa chiamata non genera o traduce le didascalie.
import os
from flashdata import FlashData
with FlashData(api_key=os.environ["FLASHDATA_API_KEY"]) as client:
response = client.youtube.transcript("dQw4w9WgXcQ", language="en", auto=True)
if response["status"] != "done":
raise RuntimeError(response)
for track in response["results"]:
print(track.get("fullText", ""))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.
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.