Vai al contenuto principale
Google SERP (Search Engine Results Page) è la pagina dei risultati che gli utenti vedono dopo aver inserito una query nel motore di ricerca Google. Mostra risultati di ricerca organici, annunci, snippet in evidenza, knowledge graph e vari contenuti come immagini e video, con l’obiettivo di fornire agli utenti le informazioni più pertinenti. Questo articolo presenterà nel dettaglio l’API Google SERP, che può fornire i risultati ottenuti inserendo una query nel motore di ricerca Google; anche il contenuto dei risultati include molti tipi, come snippet in evidenza, knowledge graph e immagini, tra gli altri risultati. Questo documento presenterà la guida all’integrazione dell’API Google SERP.

Procedura di richiesta

Per utilizzare l’API Google SERP, per prima cosa vai alla console di Ace Data Cloud per ottenere il tuo API Token, da conservare come riserva. Se non hai ancora effettuato l’accesso o la registrazione, verrai automaticamente reindirizzato alla pagina di accesso per invitarti a registrarti e ad accedere; una volta completato, tornerai automaticamente alla pagina corrente. Un solo API Token può chiamare tutti i servizi della piattaforma, senza necessità di richiederne uno separatamente per ogni servizio. Alla prima richiesta verrà assegnato un credito gratuito, che consente una prova gratuita; quando il credito è insufficiente, puoi ricaricare il saldo universale nella console.
📘 Documentazione completa: Google SERP API →

Utilizzo di base

Inserisci una parola chiave e il tipo di risorsa di ricerca per ottenere i risultati: usa query per passare la parola chiave e type per selezionare tipi di ricerca come pagine web, immagini e notizie; questa interfaccia non richiede di passare model. Ad esempio, per cercare: informazioni su “apple inc”, possiamo quindi compilare il contenuto corrispondente nell’interfaccia, come mostrato nell’immagine:

Qui possiamo vedere che abbiamo impostato i Request Headers, inclusi:
  • accept: il formato della risposta che si desidera ricevere; qui viene compilato come application/json, ovvero il formato JSON.
  • authorization: la chiave per chiamare l’API, che dopo la richiesta può essere selezionata direttamente dal menu a discesa.
Sono inoltre stati impostati i Request Body, inclusi:
  • type: il tipo di risorsa di ricerca; attualmente sono supportati solo sei tipi e il valore predefinito è search.
  • query: la parola chiave della ricerca.
  • country: il paese in cui si trovano i risultati di ricerca personalizzati; il valore predefinito sono gli Stati Uniti (US).
  • language: la lingua dei risultati di ricerca personalizzati; il valore predefinito è l’inglese (en).
  • range: l’intervallo di tempo dei risultati di ricerca personalizzati; il valore predefinito è senza limitazioni.
  • number: la dimensione della pagina di paginazione dei risultati di ricerca personalizzati; il valore predefinito è 10.
  • page: il numero di pagina della paginazione dei risultati di ricerca personalizzati; il valore predefinito è 1.
Dopo la selezione, puoi notare che anche sulla destra viene generato il codice corrispondente, come mostrato nell’immagine:

Fai clic sul pulsante «Try» per eseguire il test; come mostrato nell’immagine sopra, qui otteniamo quindi i seguenti risultati:
Il risultato restituito contiene diversi campi, descritti di seguito:
  • knowledge_graph, il grafico della conoscenza dei risultati di ricerca.
  • organic, le informazioni dettagliate dei risultati di ricerca.
  • people_also_ask, le domande relative alle parole chiave di ricerca.
  • related_searches, le ricerche correlate alle parole chiave di ricerca.
Si può vedere che nei risultati restituiti è presente un campo organic, che contiene principalmente i risultati delle parole chiave di ricerca. Inoltre, se si desidera generare il codice di integrazione corrispondente, è possibile copiarlo e generarlo direttamente; ad esempio, il codice CURL è il seguente:
Il codice di integrazione Python è il seguente:

Tipo di ricerca personalizzato

Se si personalizza il tipo di risorse di ricerca, possiamo modificare il parametro type, che include rispettivamente risorse normali search, risorse di immagini images, risorse di notizie news, risorse di mappe maps, risorse locali places e risorse video videos; in questo articolo verrà fornito un esempio con le risorse video videos. Di seguito, mostreremo le operazioni specifiche. Innanzitutto, impostare il parametro type su videos e passare normalmente il parametro query, come mostrato nell’immagine:

Il codice corrispondente è il seguente:
È possibile ottenere la seguente risposta:
Il risultato restituito contiene diversi campi, descritti come segue:
  • news, elenco delle informazioni video nei risultati di ricerca.
Si può vedere che, tra i risultati restituiti qui, è presente un campo videos, che contiene principalmente i risultati delle parole chiave di ricerca.

Personalizzare il paese in cui si trovano le risorse di ricerca

Questa interfaccia supporta anche la limitazione del paese in cui si trovano i risultati di ricerca. Possiamo aggiungere il parametro country per limitare il paese; il parametro inserito è l’abbreviazione del paese, ad esempio cn (Cina), us (Stati Uniti). In questo articolo verrà utilizzata la Cina come esempio, di seguito sono riportate le informazioni specifiche:

L’effetto dell’output è il seguente:
Come si può vedere, il risultato mostra i risultati di ricerca nel Paese Cina e il contenuto specifico è simile a quello sopra.

Lingua personalizzata dei risultati di ricerca

Possiamo anche personalizzare la lingua dei risultati di ricerca. Qui aggiungiamo ulteriormente il campo language, con contenuto zh-cn, che si riferisce alla lingua cinese semplificata; sono supportate anche altre lingue, ma è necessario inserire l’abbreviazione della lingua, come en (English), fr (French), zh-cn (Chinese(Simplified)) e altre lingue, come mostrato nell’immagine:

Il codice corrispondente è il seguente:
Il risultato dell’esecuzione è il seguente:
Si può vedere che i risultati mostrati qui sono tutti in lingua cinese semplificata e il contenuto dei risultati è simile a quello sopra.

Intervallo temporale personalizzato dei risultati di ricerca

Questo articolo consente inoltre di personalizzare l’intervallo di tempo dei risultati di ricerca, includendo cinque tipi, ovvero qdr:h (l’ultima ora), qdr:d (l’ultimo giorno), qdr:w (l’ultima settimana), qdr:m (l’ultimo mese), e nessuna limitazione per impostazione predefinita. Possiamo trasmettere l’intervallo di tempo corrispondente tramite range; ad esempio, qui è impostato su qdr:d, che indica la ricerca dei risultati dell’ultimo giorno, quindi l’input è il seguente:

Il codice corrispondente è il seguente:
Il risultato dell’esecuzione è il seguente:
Come si può vedere, abbiamo ottenuto con successo i risultati di ricerca dell’ultimo giorno, e il contenuto dei risultati è simile a quello sopra.

Personalizzare la paginazione dei risultati di ricerca

Questa API supporta inoltre la visualizzazione paginata personalizzata dei risultati di ricerca. number e page indicano rispettivamente la dimensione della pagina e il numero di pagina della paginazione. In questo articolo verrà impostata una visualizzazione paginata con 20 risultati di ricerca per pagina; le informazioni specifiche sono mostrate nell’immagine:

Nota: quando i risultati per pagina superano 10, i crediti addebitati raddoppieranno.
Il codice è il seguente:
Il risultato dell’esecuzione è il seguente:
Si può vedere che qui presenta i risultati di ricerca in pagine, con 20 risultati visualizzati per pagina, e il contenuto dei risultati è simile a quello sopra.