SerpApi

Risultati del motore di ricerca in tempo reale tramite SerpApi. Scrape Google, Bing, YouTube, Google Scholar e altro senza gestire proxy, CAPTCHAs o parser. SerpApi gestisce l'infrastruttura in modo che i flussi di lavoro ricevano json puliti e strutturati.

Questo connettore è disponibile nei prodotti e nelle aree seguenti:

Service	Class	Regions
Copilot Studio	Premium	Tutte le aree di Power Automate , ad eccezione delle seguenti:      - Governo degli Stati Uniti (GCC)      - Us Government (GCC High)      - China Cloud gestito da 21Vianet      - Dipartimento della Difesa degli Stati Uniti (DoD)
App per la logica	Standard	Tutte le aree di App per la logica , ad eccezione delle seguenti:      - Aree di Azure per enti pubblici      - Aree di Azure Cina      - Dipartimento della Difesa degli Stati Uniti (DoD)
Power Apps	Premium	Tutte le aree di Power Apps , ad eccezione dei seguenti:      - Governo degli Stati Uniti (GCC)      - Us Government (GCC High)      - China Cloud gestito da 21Vianet      - Dipartimento della Difesa degli Stati Uniti (DoD)
Power Automate	Premium	Tutte le aree di Power Automate , ad eccezione delle seguenti:      - Governo degli Stati Uniti (GCC)      - Us Government (GCC High)      - China Cloud gestito da 21Vianet      - Dipartimento della Difesa degli Stati Uniti (DoD)

Contatto
Nome	SerpApi
URL	https://serpapi.com
Email	support@serpapi.com

Metadati del connettore
Editore	SerpApi
Sito web	https://serpapi.com
Informativa sulla privacy	https://serpapi.com/legal/privacy
Categorie	Sito web; Business intelligence

SerpApi

SerpApi è un'API dei risultati del motore di ricerca in tempo reale. Gestisce proxy, CAPTCHA e analisi in modo che i flussi Power Apps e Power Automate ricevano json puliti e strutturati senza gestire alcuna infrastruttura di scraping.

Publisher: SerpApi

Prerequisiti

• Un account SerpApi. Iscriversi al serpapi.com.
• Chiave API SerpApi valida. I piani gratuiti includono 250 ricerche al mese. I piani a pagamento sono disponibili per un volume superiore.

Operazioni supportate

Google Search (GoogleSearch)

Recuperare i risultati strutturati di Google Search per una determinata query. Restituisce risultati organici, annunci, voci del grafico delle conoscenze, domande correlate, risultati locali, storie principali e altro ancora. I campi esatti restituiti dipendono dalla query e dalle superfici di Google.

Recupera posizioni (GetLocations)

Restituisce un elenco di posizioni geografiche supportate che possono essere passate al location parametro di una ricerca. Usare questa opzione per cercare la stringa di posizione esatta per una città o un'area geografica prima di eseguire una ricerca.

Ottenere informazioni sull'account (GetAccount)

Restituisce informazioni sull'account SerpApi, inclusi il piano corrente, la quota di ricerca mensile, le ricerche rimanenti e le statistiche di utilizzo orarie.

Recupero delle credenziali

1. Accedere all'account SerpApi all'indirizzo serpapi.com.
2. Passare a serpapi.com/manage-api-key.
3. Copia la chiave API.
4. Quando si crea una connessione in Power Apps o Power Automate, incollare la chiave API nel campo Chiave API.

La chiave API viene archiviata in modo sicuro da Power Platform e inserita automaticamente in ogni richiesta. Non sarà necessario specificarlo di nuovo dopo la configurazione della connessione.

Getting Started

Utilizzo di base

L'azione GoogleSearch accetta un argomento obbligatorio (la query di ricerca) e un record facoltativo di parametri aggiuntivi:

Set(varJsonResponse, SerpApi.GoogleSearch("coffee"))

Per visualizzare la risposta JSON non elaborata in un controllo Testo HTML per il debug:

$"<pre>{JSON(varJsonResponse, JSONFormat.IndentFour)}</pre>"

Passaggio di parametri facoltativi

I parametri facoltativi vengono passati come record (il secondo argomento). Includere solo i parametri che si desidera impostare, omettendo una chiave non viene inviato alcun valore per tale parametro, consentendo a SerpApi di usare il proprio valore predefinito.

Nell'esempio seguente i tipi di input e i nomi sono consigli, non obbligatori.

Set(varJsonResponse, SerpApi.GoogleSearch(
    searchQueryInput.Text,
    {
        location: locationInput.Text,
        gl: glInput.Text,
        hl: hlInput.Text,
        lat: latInput.Text,
        lon: lonInput.Text,
        radius: radiusInput.Text,
        uule: uuleInput.Text,
        google_domain: googleDomainInput.Text,
        cr: crInput.Text,
        lr: lrInput.Text,
        tbs: tbsInput.Text,
        nfpr: nfprCheckbox.Value,
        filter: filterCheckbox.Value,
        safe: safeDropdown.Selected.Value,
        device: deviceDropdown.Selected.Value,
        tbm: tbmDropdown.Selected.Value,
        start: startInput.Text,
        ludocid: ludocidInput.Text,
        lsig: lsigInput.Text,
        kgmid: kgmidInput.Text,
        si: siInput.Text,
        ibp: ibpInput.Text,
        uds: udsInput.Text,
        no_cache: noCacheCheckbox.Value
    }
))

Mapping dei tipi di controllo:

Tipo di parametro	Controllo Power Apps consigliato	Riferimento al valore
Testo (stringa)	Input di testo	controlName.Text
Boolean	Attiva/disattiva o casella di controllo	controlName.Value
Enumerazione (opzioni fisse)	Menu a discesa	controlName.Selected.Value
Number	Input di testo	controlName.Text

Accesso ai dati di risposta

La risposta è un oggetto JSON. Accedere alle proprietà di primo livello direttamente dalla variabile:

varJsonResponse.search_information.total_results

Per associare una raccolta ai risultati organici:

varJsonResponse.organic_results

Per associare una raccolta ai risultati aziendali locali:

varJsonResponse.local_results.places

Per l'elenco completo dei campi di risposta, vedere la documentazione di Ricerca Google SerpApi .

Ricerca di una stringa di posizione valida

Usare GetLocations per trovare il nome esatto della posizione da passare a GoogleSearch. Il q parametro filtra in base al nome della città o dell'area e limit delimita il numero di risultati restituiti.

Set(varLocations, SerpApi.GetLocations("Austin", {limit: 5}))

Per associare i risultati a una raccolta:

varLocations

Ogni elemento dell'insieme include namecampi , canonical_namecountry_code, target_type, reach, e gps . Passare il canonical_name valore come location parametro in una chiamata successiva GoogleSearch :

Set(varResults, SerpApi.GoogleSearch(
    "coffee shops",
    {location: locationGallery.Selected.canonical_name}
))

Controllo dell'utilizzo dell'account

Usare GetAccount per recuperare i dettagli del piano corrente e l'utilizzo della quota. Ciò è utile per controllare il numero di ricerche che rimangono prima di raggiungere il limite mensile.

Set(varAccount, SerpApi.GetAccount())

Accedere ai singoli campi dalla risposta:

varAccount.plan_searches_left
varAccount.this_month_usage
varAccount.account_rate_limit_per_hour

Per l'elenco completo dei campi di risposta, vedere la documentazione dell'API Account SerpApi .

Problemi noti e limitazioni

• Struttura della risposta variabile: i campi presenti in una risposta di Ricerca Google dipendono dalla query e dal risultato restituito da Google. Non tutti i campi vengono visualizzati in ogni risposta. Per una descrizione completa dei possibili campi di risposta, vedere la documentazione di Ricerca Google SerpApi .
• Limiti di frequenza: le richieste sono soggette alla quota mensile del piano SerpApi e al limite di frequenza oraria. Se si supera uno dei due, verrà restituita una 429 risposta di errore.
• Risultati memorizzati nella cache: per impostazione predefinita, SerpApi gestisce i risultati dalla cache per le richieste duplicate specifiche di ogni utente (fino a 1 ora precedente). Usare il no_cache parametro per forzare un nuovo risultato. Si noti che le ricerche memorizzate nella cache non vengono conteggiate per la quota mensile.

Support

Per informazioni su questo connettore o sull'account SerpApi, contattare il team di supporto di SerpApi:

• Email:contact@serpapi.com
• Live chat: disponibile il 24/7 al serpapi.com, dove è possibile parlare direttamente con un membro del team di supporto di SerpApi.

Creazione di una connessione

Il connettore supporta i tipi di autenticazione seguenti:

Predefinita	Parametri per la creazione della connessione.	Tutte le aree geografiche	Non condivisibile

Predefinito

Applicabile: tutte le aree

Parametri per la creazione della connessione.

Questa connessione non è condivisibile. Se l'app power viene condivisa con un altro utente, verrà richiesto a un altro utente di creare una nuova connessione in modo esplicito.

Nome	Tipo	Description	Obbligatorio
Chiave API	securestring	Chiave API SerpApi. Trovalo all'indirizzo https://serpapi.com/manage-api-key	True

Azioni

Ottenere informazioni sull'account	Restituisce informazioni sull'account SerpApi autenticato, inclusi i dettagli del piano, le ricerche rimanenti e le statistiche di utilizzo.
Recupera posizioni	Restituisce un elenco di posizioni geografiche supportate che possono essere usate con il parametro location in una ricerca. Utile per trovare la stringa di posizione esatta per una città o un'area geografica.
Ricerca Google	Recuperare i risultati strutturati di Google Search per una determinata query. Restituisce risultati organici, annunci, knowledge graph, domande correlate, storie principali, risultati locali e altro ancora.

Ottenere informazioni sull'account

ID operazione:

GetAccount

Restituisce informazioni sull'account SerpApi autenticato, inclusi i dettagli del piano, le ricerche rimanenti e le statistiche di utilizzo.

Valori restituiti

Informazioni sull'account SerpApi autenticato.

Corpo

AccountInfo

Recupera posizioni

ID operazione:

GetLocations

Restituisce un elenco di posizioni geografiche supportate che possono essere usate con il parametro location in una ricerca. Utile per trovare la stringa di posizione esatta per una città o un'area geografica.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
Termine di ricerca	q		string	Nome della città o dell'area geografica per filtrare l'elenco delle località disponibili (ad esempio Austin).
Limit	limit		integer	Numero massimo di posizioni da restituire.

Valori restituiti

response

array of Location

Ricerca Google

ID operazione:

GoogleSearch

Recuperare i risultati strutturati di Google Search per una determinata query. Restituisce risultati organici, annunci, knowledge graph, domande correlate, storie principali, risultati locali e altro ancora.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
Query di ricerca	q	True	string	Query di ricerca. Supporta tutti gli operatori standard ,ad esempio site:, inurl:, intitle:) e parametri avanzati, ad esempio as_dt e as_eq.
Posizione	location		string	Posizione da cui ha origine la ricerca. Specificare a livello di città l'accuratezza migliore (ad esempio Austin, Texas). Non può essere usato insieme ai parametri uule, lat o lon. https://serpapi.com/locations-api Vedere per le posizioni supportate.
Percorso codificato (UULE)	uule		string	Stringa di posizione codificata di Google. Usare come alternativa al parametro location per una georilevazione precisa. Non può essere utilizzato insieme a posizione, lat, lon o raggio.
Latitudine	lat		number	Latitudine GPS per l'origine di ricerca. Obbligatorio quando si usa il parametro lon. Non può essere usato insieme alla posizione o all'uule.
Longitudine	lon		number	Longitudine GPS per l'origine di ricerca. Obbligatorio quando si usa il parametro lat. Non può essere usato insieme alla posizione o all'uule.
Raggio (metri)	radius		integer	Distanza in metri entro la quale distorsione dei risultati della ricerca. I risultati all'interno di questa area sono classificati più in alto. Può essere utilizzato insieme a posizione o lat/lon. Raggio massimo: 199 m sul desktop; 1000 m su tablet o cellulare. Non può essere usato insieme a uule.
Dominio Google	google_domain		string	Dominio Google da usare (ad esempio, google.com, google.co.uk, google.fr). Il valore predefinito è google.com. Vedere https://serpapi.com/google-domains per l'elenco completo.
Country	gl		string	Codice paese a due lettere per la ricerca (ad esempio, us, gb, fr, de). Vedere https://serpapi.com/google-countries per l'elenco completo.
Language	hl		string	Codice lingua dell'interfaccia a due lettere (ad esempio en, es, fr, de). Vedere https://serpapi.com/google-languages per l'elenco completo.
Limitazione paese	cr		string	Limitare i risultati ai documenti provenienti da paesi specifici. Usare il formato country{CODE} con | come delimitatore (ad esempio countryFR|countryDE).
Limitazione del linguaggio	lr		string	Limitare i risultati a lingue specifiche. Usare il formato lang_{code} con | come delimitatore (ad esempio, lang_fr|lang_de).
Filtro ricerca avanzata	tbs		string	Filtro di ricerca avanzato (da cercare). Abilita il filtro in base all'intervallo di date, al tipo di contenuto e altro ancora (ad esempio qdr:d per il giorno precedente, qdr:w per la settimana precedente).
Ricerca sicura	safe		string	Livello di filtro dei contenuti per adulti. Impostare su attivo per abilitare il filtro o disabilitarlo.
Escludere i risultati con correzione automatica	nfpr		integer	Impostare su 1 per escludere i risultati dalle query con correzione automatica quando la query originale viene digitata in modo non corretto. Impostare su 0 per includerli (impostazione predefinita).
Filtro contenuto duplicato	filter		integer	Controlla risultati simili e filtri risultati omessi. Impostare su 1 per abilitare (impostazione predefinita) o 0 per disabilitare.
Tipo di ricerca	tbm		string	Tipo di ricerca google da eseguire (da trovare). Omettere per una normale ricerca Web.
Offset risultato	start		integer	Offset di paginazione. Ignora il numero specificato di risultati. 0 restituisce la prima pagina, 10 restituisce la seconda pagina e così via.
Dispositivo	device		string	Tipo di dispositivo da simulare. Usa desktop (impostazione predefinita), tablet o dispositivi mobili.
Ignorare la cache	no_cache		boolean	Impostare su true per forzare un nuovo risultato, ignorando la cache di 1 ora di SerpApi. Le ricerche memorizzate nella cache sono gratuite e non vengono conteggiate per la quota mensile. Non usare insieme a asincrona.
Modalità asincrona	async		boolean	Impostare su true per inviare la ricerca e recuperare i risultati in un secondo momento tramite l'API di archiviazione della ricerca, anziché attendere i risultati in modo sincrono. Non usare insieme a no_cache.
Formato di output	output		string	Formato dell'output. Impostare su json (impostazione predefinita) per JSON strutturato o html per HTML non elaborato. Usare html per il debug o per i tipi di risultati non ancora completamente supportati.
Posizionare CID	ludocid		string	Google CID (identificatore cliente) di un luogo specifico. Trovato nei risultati locali come place_id. Usato per recuperare il grafico delle conoscenze di una posizione.
Knowledge Graph ID	kgmid		string	KGMID di un'entità Google Knowledge Graph. Può eseguire l'override di altri parametri di ricerca tranne start.
Firma locale (lsig)	lsig		string	Usato per forzare la visualizzazione mappa del grafico delle informazioni per una posizione locale. Ottenere tramite l'API Local Pack o l'API locale di Google.
Parametri di ricerca memorizzati nella cache (si)	si		string	Parametri di ricerca crittografati memorizzati nella cache per le schede Knowledge Graph. Può eseguire l'override di altri parametri di ricerca tranne start.
Espansione layout (ibp)	ibp		string	Controlla le espansioni del layout nei risultati di Google (ad esempio gwp; 0,7).
Stringa di filtro (uds)	uds		string	Stringa di filtro fornita da Google per il filtro dei risultati.
Nessuna traccia	zero_trace		boolean	Solo account aziendali. Impostare su true per ignorare l'archiviazione lato server dei parametri di ricerca e dei metadati.

Valori restituiti

Nome	Percorso	Tipo	Descrizione
search_metadata	search_metadata	object	Metadati relativi alla richiesta di ricerca, inclusi gli identificatori di stato, intervallo e SerpApi.
search_parameters	search_parameters	object	I parametri usati per questa ricerca, restituiti dalla richiesta.
search_information	search_information	object	Informazioni generali sulla ricerca, ad esempio il conteggio totale dei risultati e il tempo impiegato.
organic_results	organic_results	array of object	Risultati Web biologici standard restituiti da Google.
items	organic_results	object
Annunci	ads	array of object	Annunci a pagamento mostrati sopra o sotto risultati organici.
items	ads	object
knowledge_graph	knowledge_graph	object	Dati del pannello google Knowledge Graph, se presenti per la query.
related_questions	related_questions	array of object	Le persone fanno anche domande correlate alla query.
items	related_questions	object
related_searches	related_searches	array of object	Suggerimenti di ricerca correlati visualizzati nella parte inferiore della pagina dei risultati.
items	related_searches	object
local_results	local_results	object	Risultati del pacchetto locale, presenti quando la query ha finalità locali.
top_stories	top_stories	array of object	Notizie principali correlate alla query.
items	top_stories	object
Paginazione	pagination	object	Collegamenti alle pagine successive e precedenti dei risultati.

Definizioni

Posizione

Posizione geografica supportata da usare con il parametro di ricerca della posizione.

Nome	Percorso	Tipo	Descrizione
id	id	string	Identificatore univoco per questo percorso.
nome	name	string	Nome completo della località (ad esempio Austin, Texas, Stati Uniti).
canonical_name	canonical_name	string	Nome canonico usato nel parametro location.
country_code	country_code	string	Codice paese ISO a due lettere.
target_type	target_type	string	Tipo di località (ad esempio Città, Area DMA, Paese).
Raggiungere	reach	integer	Il volume di ricerca mensile stimato raggiunge questo percorso.
gps	gps	array of number	Coordinate GPS come [latitudine, longitudine].

Informazioni sull'account

Informazioni sull'account SerpApi autenticato.

Nome	Percorso	Tipo	Descrizione
account_id	account_id	string	Identificativo univoco per l'account.
chiave_api	api_key	string	Chiave API per questo account.
account_email	account_email	string	Indirizzo di posta elettronica associato all'account.
plan_name	plan_name	string	Nome del piano di sottoscrizione corrente.
plan_monthly_price	plan_monthly_price	number	Prezzo mensile del piano corrente in USD.
searches_per_month	searches_per_month	integer	Numero totale di ricerche incluse al mese nel piano corrente.
plan_searches_left	plan_searches_left	integer	Numero di ricerche rimanenti nel periodo di fatturazione corrente.
extra_credits	extra_credits	integer	Crediti di ricerca aggiuntivi acquistati al di fuori del piano.
account_rate_limit_per_hour	account_rate_limit_per_hour	integer	Numero massimo di richieste API consentite all'ora.
this_month_usage	this_month_usage	integer	Numero di ricerche usate finora per questo periodo di fatturazione.
this_hour_searches	this_hour_searches	integer	Numero di ricerche effettuate nell'ora corrente.
last_hour_searches	last_hour_searches	integer	Numero di ricerche effettuate nell'ora precedente.