Sfoglia la documentazione
Riferimento API
Google News API
Recuperare gli articoli Google News con titoli, pubblicazioni, link e date di pubblicazione. Filtra per paese, lingua e data range.
Crea una richiesta
Parametri avanzati
La numerazione parte da 1. Ogni pagina richiede una richiesta separata.
Filtro temporale di Google, ad esempio qdr:d per le ultime 24 ore.
https://data.flashdata.dev/v1/queries/realtimeParametri
Invia source e query al livello superiore. Le opzioni di origine appartengono in params. I campi opzionali possono essere omessi.
Corpo della richiesta
sourcestring / Obbligatorio- Impostare su google_news.
querystring / Obbligatorio- Cerca la query. Supporta gli operatori di ricerca Google come il sito: e intitle:.1 a 2000 caratteriPredefinito:
Non impostato paramsobject / Facoltativo- Settings per questa richiesta.Predefinito:
{} callback_urlstring · nullable / Facoltativo- Async e solo lotto. Completamento HTTPS pubblico URL sulla porta 443, fino a caratteri 2,048. Nessuna credenziali utente o frammentazione URL. Omit, utilizzare null o una stringa vuota per nessuna notifica. In un lotto, impostare questo su ogni query, param esterni.Predefinito:
Non impostato
Paese, lingua e luogo
params.glstring / Facoltativo- Codice paese a due lettere, come noi, gb, de o sg. Impostare esplicitamente per selezionare un paese.Esattamente. 2 caratteriPredefinito:
Non impostatoFormato accettato
^[A-Za-z]{2}$ params.hlstring / Facoltativo- Lingua di interfaccia Google. Impostare esplicitamente per selezionare una lingua.1 a 35 caratteriPredefinito:
Non impostatoFormato accettato
^[A-Za-z0-9-]+$ params.locationstring / Facoltativo- Posizione di ricerca richiesta, preferibilmente una città, come "London, England, United Kingdom". La disponibilità dipende dal tipo di ricerca.1 a 200 caratteriPredefinito:
Non impostato
Pagina
params.numinteger / Facoltativo- Conto di risultato richiesto. FlashData non aggiunge un default fisso quando omesso. Il conteggio restituito può differire per query e tipo di ricerca.1 a 100, numeri interiPredefinito:
Non impostato params.pageinteger / Facoltativo- Pagina dei risultati richiesta. Impostare esplicitamente. Ogni pagina è una richiesta API separata.1 a 100, numeri interiPredefinito:
Non impostato
Cerca filtri
params.tbsstring / Facoltativo- Filtri di ricerca Google richiesti, come qdr:d per il giorno passato o qdr:w per la settimana passata. La disponibilità dipende dal tipo di ricerca.1 a 200 caratteriPredefinito:
Non impostato params.autocorrectboolean / Facoltativo- Richiedere correzione ortografia con true o richiederlo disabilitato con false. Il comportamento applicato dipende dal tipo di ricerca; ometti di utilizzare il comportamento di Google.
trueofalsePredefinito:Non impostato
Risposta
Realtime restituisce status: done con l'output di ricerca in results[0]. Le partite sono in results[0].news. usage.credits registra l'accusa.
Gli articoli includono titoli e link. Le date di pubblicazione possono essere testo relativo; frammenti, editori e miniature possono essere assenti.
Leggi il risultato
Salvare la risposta di successo JSON come response.json. Salvare questo come read-response.py ed eseguire pitone read-response.py. Utilizza solo la libreria standard di Python e non fa nuove richieste.
import json
from pathlib import Path
response = json.loads(Path("response.json").read_text(encoding="utf-8-sig"))
if response.get("status") not in ("done", "completed") or not isinstance(response.get("results"), list):
raise SystemExit("Expected completed result JSON; inspect the response or job status.")
if not response["results"]:
print("[]")
raise SystemExit(0)
result = response["results"][0]
output = [
{"title": item.get("title"), "url": item.get("link"), "publisher": item.get("source"), "date": item.get("date")}
for item in result.get("news", [])
]
print(json.dumps(output, ensure_ascii=False, indent=2))I campi disponibili dipendono dal tipo di query e ricerca. I campi opzionali possono essere assenti e possono essere restituiti altri campi.
Il numero di articoli restituiti e searchParameters.num può differire da params.num. Utilizzare l'array restituito per determinare il conteggio effettivo dei risultati.
Tutti i campi di risposta
| Campo di applicazione | Designazione |
|---|---|
sourcestring | La fonte API richiesta. |
statusstring | fatto quando la richiesta in tempo reale riesce. |
created_atstring | Tempo di creazione di risposta in formato ISO 8601. |
usage.creditsnumber | Crediti a carico della richiesta, in base al tuo piano. |
results[0].searchParametersobject | Impostazioni di ricerca riportate da Google, con la query registrata come q. Le impostazioni restituite possono differire dai valori richiesti. |
results[0].newsarray | Risultati di ricerca. |
results[0].news[].titlestring | Titolo dell'articolo. |
results[0].news[].linkstring | Articolo URL. |
results[0].news[].snippetstring · optional | Articolo estratto. |
results[0].news[].sourcestring · optional | Nome di pubblicazione. |
results[0].news[].datestring · optional | Data di pubblicazione come restituita da Google; può essere relativa. |
results[0].news[].imageUrlstring · optional | Articolo miniatura. |
results[0].news[].positioninteger · optional | Posizione del risultato, quando incluso. |
I campi sopra descritti descrivono la risposta predefinita JSON. formati JSON, testo semplice e Markdown.
Async & ciclo di vita in batch
La sottomissione restituisce una ricevuta, non i risultati. Async crea un lavoro; batch restituisce un lavoro separato in queries[] per ogni domanda accettata. Tracciare e recuperare ogni lavoro in modo indipendente.
Inviare a data.flashdata.dev; leggi lo stato del lavoro e i risultati ottenuti api.flashdata.dev con lo stesso X-API-Key. Gli esempi di base API collegati utilizzano Python e cURL.
1. Salvare il lavoro IDs
Mantenere i campi di richiesta di questa fonte quando si passa a Async. Per Batch, inserire ogni richiesta all'interno dell'array query di un oggetto JSON. Salvare ogni lavoro restituito ID.
2. Controllare lo stato
GET https://api.flashdata.dev/v2/jobs/{jobId}pending/processing: sondaggio con ritardo e rispettoRetry-Afterquando presente.completed: risultati di ricerca.failed: ispezionejob.error.Leggi job.status, non lo stato della ricevuta di presentazione.
Stato di controllo · Python e cURL
Stato del lavoro API riferimento3. Risultati di riduzione
GET https://api.flashdata.dev/v2/jobs/{jobId}/resultsDopo il completamento, autenticare il risultato letto, quindi prendere il 302 di archiviazione URL senza la chiave API. Salvare la JSON entro le ore di completamento 24.
Risultati di riduzione · Python e cURL · Formati di risposta
Risultato download API riferimento
L'inquinamento e l'ottenimento dei risultati esistenti non consumano i crediti di query. Un timeout inquinante non cancella il lavoro: mantieni il suo ID invece di presentare il lavoro duplicato fatturabile. Codici di errore e comportamento di riprovazione.
Webhook di completamento
Iscriviti per query
Set Set callback_url al livello superiore di una richiesta asincrona, o dentro ogni query in un lotto, fuori params. Non è richiesta alcuna richiesta di registrazione webhook separata. Le richieste di Realtime non inviano i callback.
Utilizzare un HTTPS URL pubblico sulla porta 443. FlashData POSTs una notifica per ogni lavoro che raggiunge completed o failed; l'evento contiene collegamenti, non il risultato stesso.
Riconoscimento e verifica
Ritorno 2xx dopo aver accettato duramente l'evento. Deduplicato da delivery_id, anche inviato come X-Delivery-Id. I reindirizzamenti non sono seguiti.
Recuperare le consegne non effettuate con backoff esponenziale, fino a 8 tenta totale e al massimo 24 ore dopo il completamento. Continua a inquinare come un fallback.
Le chiamate non sono firmate. Confermare il lavoro ID, lo stato sorgente e terminale attraverso endpoint di stato autenticato prima di elaborare la notifica. La consegna ID è per la deduplica, non la prova di autenticità.
Esempio webhook evento e campi
{
"delivery_id": "completion:job_example0001",
"id": "job_example0001",
"source": "google_news",
"status": "completed",
"links": [
{
"rel": "self",
"href": "https://api.flashdata.dev/v2/jobs/job_example0001",
"method": "GET"
},
{
"rel": "results",
"href": "https://api.flashdata.dev/v2/jobs/job_example0001/results",
"method": "GET"
}
]
}| Campo di applicazione | Designazione |
|---|---|
delivery_idstring | Identificatore di consegna stabile. Deduplicare le notifiche utilizzando questo valore; viene inviato anche nell'intestazione X-Delivery-Id. |
idstring | Lavoro ID. |
sourcestring | Fonte di dati richiesta. |
statusstring | completato o fallito. |
linksarray | Collegamenti di stato e di risultato. Le notifiche non includono il contenuto dei risultati o una chiave API. |
links[].relstring | auto o risultati. |
links[].hrefstring | Gestione assoluta API URL; autenticare con la chiave API. |
links[].methodstring | GET. |
Recupero di errore
Una ricerca completa può contenere meno partite di quanto richiesto. Check gl, hl, ubicazione e filtri; i campi facoltativi di risultato possono essere assenti.
Per l'autenticazione, l'equilibrio, il formato delle richieste e i guasti dei limiti di velocità, utilizzare il riferimento di errore condiviso. Un timeout di presentazione può ancora aver creato un lavoro; controllare il lavoro esistente prima di riprovare.
Guida passo-passo: Scegliere e affinare una ricerca Google
Prezzi
| Piani | Tassi di utilizzoper 1.000 richieste | Abbonamenti | Crediti inclusi per periodo di fatturazione |
|---|---|---|---|
| A consumo | 1,00 USD | Nessun canone mensile | Ricarica quando serve |
| Micro | 0,80 USD | 49,00 USD / mese | Crediti 1000 (50,00 USD dell'utilizzo API) inclusi |
| Starter | 0,65 USD | 199,00 USD / mese | Crediti 4000 (200,00 USD dell'utilizzo API) inclusi |
| Pro | 0,60 USD | 499,00 USD / mese | Crediti 10.000 (500,00 USD dell'utilizzo API) inclusi |
| Scale | 0,50 USD | 999,00 USD / mese | Crediti 20.000 (1000,00 USD dell'utilizzo API) inclusi |
| Business | 0,40 USD | 1999,00 USD / mese | Crediti 40.000 (2000,00 USD dell'utilizzo API) inclusi |
Un piano per account. Crediti condivisi tra i tre prodotti. L’utilizzo coperto dai crediti inclusi non viene addebitato nuovamente.
I prezzi attuali e i limiti del piano