Salta al contenuto
IT
Ottieni la chiave API
Sfoglia la documentazione

Riferimento API

Google Images API

Ottieni una chiave API

Cerca Google Immagini e recupera l'immagine originale URLs, miniature, dimensioni e pagine di origine come JSON.

Crea una richiesta

Parametri avanzati

La numerazione parte da 1. Ogni pagina richiede una richiesta separata.

Google tbs espressione. I filtri supportati variano per tipo di ricerca.

POSThttps://data.flashdata.dev/v1/queries/realtime
Python 3 · requests
python3 -m pip install requests
import json

import requests

api_key = "YOUR_API_KEY"
payload = {
    "source": "google_images",
    "query": "tokyo skyline",
    "params": {
        "gl": "us",
        "hl": "en",
        "num": 50,
        "page": 1,
    },
}

response = requests.post(
    "https://data.flashdata.dev/v1/queries/realtime",
    headers={"X-API-Key": api_key, "Accept": "application/json"},
    json=payload,
    timeout=120,
)
response.raise_for_status()
print(json.dumps(response.json(), ensure_ascii=False, indent=2))
Risultati nella risposta HTTPautenticazione X-API-Key

Parametri

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_images.
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 impostato
Formato accettato^[A-Za-z]{2}$
params.hlstring / Facoltativo
Lingua di interfaccia Google. Impostare esplicitamente per selezionare una lingua.
1 a 35 caratteriPredefinito: Non impostato
Formato 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.
true o falsePredefinito: Non impostato

Risposta

Realtime restituisce status: done con l'output di ricerca in results[0]. Le partite sono in results[0].images. usage.credits registra l'accusa.

imageUrl identifica l'immagine originale; il link identifica la sua pagina di origine. Le dimensioni dell'immagine e le miniature sono facoltative. I risultati contengono URLs e metadati, non file di immagine.

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.

read-response.py
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"), "imageUrl": item.get("imageUrl"), "sourcePage": item.get("link")}
    for item in result.get("images", [])
]
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 applicazioneDesignazione
sourcestringLa fonte API richiesta.
statusstringfatto quando la richiesta in tempo reale riesce.
created_atstringTempo di creazione di risposta in formato ISO 8601.
usage.creditsnumberCrediti a carico della richiesta, in base al tuo piano.
results[0].searchParametersobjectImpostazioni di ricerca riportate da Google, con la query registrata come q. Le impostazioni restituite possono differire dai valori richiesti.
results[0].imagesarrayRisultati di ricerca delle immagini.
results[0].images[].titlestringTitolo immagine.
results[0].images[].imageUrlstringImmagine originale URL.
results[0].images[].imageWidthinteger · optionalLarghezza immagine originale in pixel.
results[0].images[].imageHeightinteger · optionalAltezza immagine originale in pixel.
results[0].images[].thumbnailUrlstring · optionalThumbnail URL.
results[0].images[].thumbnailWidthinteger · optionalLarghezza di frusta in pixel.
results[0].images[].thumbnailHeightinteger · optionalAltezza della lunetta in pixel.
results[0].images[].linkstringPagina contenente l'immagine.
results[0].images[].sourcestring · optionalNome del sito web di origine.
results[0].images[].domainstring · optionalDominio sorgente.
results[0].images[].positionintegerPosizione dei risultati.
results[0].images[].googleUrlstring · optionalGoogle Images risultato URL quando disponibile.

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

    Async richiesta e ricevuta · Corpo di richiesta Batch

  2. 2. Controllare lo stato

    GET https://api.flashdata.dev/v2/jobs/{jobId}

    pending / processing: sondaggio con ritardo e rispetto Retry-After quando presente. completed: risultati di ricerca. failed: ispezione job.error.

    Leggi job.status, non lo stato della ricevuta di presentazione.

    Stato di controllo · Python e cURL

    Stato del lavoro API riferimento
  3. 3. Risultati di riduzione

    GET https://api.flashdata.dev/v2/jobs/{jobId}/results

    Dopo 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
Notifica di completamento illustrativa
{
  "delivery_id": "completion:job_example0001",
  "id": "job_example0001",
  "source": "google_images",
  "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 applicazioneDesignazione
delivery_idstringIdentificatore di consegna stabile. Deduplicare le notifiche utilizzando questo valore; viene inviato anche nell'intestazione X-Delivery-Id.
idstringLavoro ID.
sourcestringFonte di dati richiesta.
statusstringcompletato o fallito.
linksarrayCollegamenti di stato e di risultato. Le notifiche non includono il contenuto dei risultati o una chiave API.
links[].relstringauto o risultati.
links[].hrefstringGestione assoluta API URL; autenticare con la chiave API.
links[].methodstringGET.

Contratto completo di webhook e restrizioni URL

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.

Errori e codici di stato · Quando riprova · Limiti di tasso

Guida passo-passo: Scegliere e affinare una ricerca Google

Prezzi

PianiTassi di utilizzoper 1.000 richiesteAbbonamentiCrediti inclusi per periodo di fatturazione
A consumo1,00 USDNessun canone mensileRicarica quando serve
Micro0,80 USD49,00 USD / meseCrediti 1000 (50,00 USD dell'utilizzo API) inclusi
Starter0,65 USD199,00 USD / meseCrediti 4000 (200,00 USD dell'utilizzo API) inclusi
Pro0,60 USD499,00 USD / meseCrediti 10.000 (500,00 USD dell'utilizzo API) inclusi
Scale0,50 USD999,00 USD / meseCrediti 20.000 (1000,00 USD dell'utilizzo API) inclusi
Business0,40 USD1999,00 USD / meseCrediti 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