SerpApi

Resultat från sökmotorn i realtid via SerpApi. Skrapa Google, Bing, YouTube, Google Scholar med mera utan att hantera proxyservrar, CAPTCHA:er eller parsare. SerpApi hanterar infrastrukturen så att dina arbetsflöden får ren, strukturerad JSON.

Den här anslutningsappen är tillgänglig i följande produkter och regioner:

Service	Class	Regioner
Copilot Studio	Premie	Alla Power Automate-regioner utom följande: - Amerikanska myndigheter (GCC) - Amerikanska myndigheter (GCC High) – China Cloud drivs av 21Vianet - US Department of Defense (DoD)
Logiska appar	Standard	Alla Logic Apps-regioner utom följande: – Azure Government-regioner – Regioner i Azure Kina - US Department of Defense (DoD)
Power Apps	Premie	Alla Power Apps-regioner utom följande: - Amerikanska myndigheter (GCC) - Amerikanska myndigheter (GCC High) – China Cloud drivs av 21Vianet - US Department of Defense (DoD)
Power Automate	Premie	Alla Power Automate-regioner utom följande: - Amerikanska myndigheter (GCC) - Amerikanska myndigheter (GCC High) – China Cloud drivs av 21Vianet - US Department of Defense (DoD)

Kontakt
Name	SerpApi
URL	https://serpapi.com
E-postmeddelande	support@serpapi.com

Metadata för anslutningsprogram
Publisher	SerpApi
Webbplats	https://serpapi.com
Sekretesspolicy	https://serpapi.com/legal/privacy
Kategorier	Webbplats; Business Intelligence

SerpApi

SerpApi är ett API för sökmotorresultat i realtid. Den hanterar proxyservrar, CAPTCHA:er och parsning så att dina Power Apps- och Power Automate-flöden får ren, strukturerad JSON utan att hantera någon skrapande infrastruktur.

Publisher: SerpApi

Förutsättningar

Ett SerpApi-konto. Registrera dig på serpapi.com.
En giltig SerpApi API-nyckel. I de kostnadsfria abonnemangen ingår 250 sökningar per månad. Betalda abonnemang är tillgängliga för högre volym.

Åtgärder som stöds

Google Search (`GoogleSearch`)

Hämta strukturerade Google Search-resultat för en viss fråga. Returnerar organiska resultat, annonser, poster i kunskapsdiagram, relaterade frågor, lokala resultat, toppberättelser med mera. De exakta fält som returneras beror på frågan och vilka Google-ytor som finns för den.

Hämta platser (`GetLocations`)

Returnerar en lista över geografiska platser som stöds och som kan skickas till parametern location för en sökning. Använd detta för att leta upp den exakta platssträngen för en stad eller region innan du kör en sökning.

Hämta kontoinformation (`GetAccount`)

Returnerar information om ditt SerpApi-konto, inklusive din aktuella plan, månatlig sökkvot, återstående sökningar och användningsstatistik per timme.

Hämta autentiseringsuppgifter

Logga in på ditt SerpApi-konto på serpapi.com.
Gå till serpapi.com/manage-api-key.
Kopiera DIN API-nyckel.
När du skapar en anslutning i Power Apps eller Power Automate klistrar du in DIN API-nyckel i FÄLTET API-nyckel.

Din API-nyckel lagras säkert av Power Platform och matas automatiskt in i varje begäran. Du behöver inte ange den igen när anslutningen har konfigurerats.

Getting Started

Grundläggande användning

Åtgärden GoogleSearch tar ett obligatoriskt argument (sökfrågan) och en valfri post med ytterligare parametrar:

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

Så här visar du det råa JSON-svaret i en HTML-textkontroll för felsökning:

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

Skicka valfria parametrar

Valfria parametrar skickas som en post (det andra argumentet). Inkludera endast de parametrar som du vill ange – om du utelämnar en nyckel skickas ingenting för den parametern, så att SerpApi kan använda sin egen standard.

I följande exempel är indatatyperna och namnen rekommendationer, inte obligatoriska.

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
    }
))

Mappning av kontrolltyp:

Parametertyp	Rekommenderad Power Apps kontroll	Värdereferens
Text (sträng)	Textinmatning	`controlName.Text`
Boolean	Växla eller kryssruta	`controlName.Value`
Uppräkning (fasta alternativ)	Listruta	`controlName.Selected.Value`
Siffra	Textinmatning	`controlName.Text`

Åtkomst till svarsdata

Svaret är ett JSON-objekt. Få åtkomst till egenskaper på den översta nivån direkt från variabeln:

varJsonResponse.search_information.total_results

Så här binder du ett galleri till de organiska resultaten:

varJsonResponse.organic_results

Så här binder du ett galleri till lokala affärsresultat:

varJsonResponse.local_results.places

I Dokumentationen för SerpApi Google Search finns en fullständig lista över svarsfält.

Leta upp en giltig platssträng

Använd GetLocations för att hitta det exakta platsnamnet som ska skickas till GoogleSearch. Parametern q filtrerar efter ort eller regionnamn och limit begränsar antalet returnerade resultat.

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

Så här binder du resultatet till ett galleri:

varLocations

Varje objekt i samlingen har namefälten , canonical_name, country_code, target_type, reachoch gps . Skicka värdet canonical_name som location parameter i ett efterföljande GoogleSearch anrop:

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

Kontrollera kontoanvändning

Använd GetAccount för att hämta din aktuella planinformation och kvotanvändning. Detta är användbart för att kontrollera hur många sökningar som återstår innan du når din månadsgräns.

Set(varAccount, SerpApi.GetAccount())

Få åtkomst till enskilda fält utanför svaret:

varAccount.plan_searches_left
varAccount.this_month_usage
varAccount.account_rate_limit_per_hour

I dokumentationen för SerpApi-konto-API :et finns en fullständig lista över svarsfält.

Kända problem och begränsningar

Variabel svarsstruktur: Fälten som finns i ett Google Search-svar beror på frågan och vad Google returnerar för den. Alla fält visas inte i varje svar. I Dokumentationen för SerpApi Google Search finns en fullständig beskrivning av möjliga svarsfält.
Hastighetsgränser: Begäranden omfattas av serpApi-planens månatliga kvot och timprisgräns. Om du överskrider något av dessa resulterar det i ett 429 felsvar.
Cachelagrade resultat: SerpApi hanterar som standard resultat från cacheminnet för duplicerade begäranden som är specifika för varje användare (upp till 1 timme gamla). Använd parametern no_cache för att framtvinga ett nytt resultat. Observera att cachelagrade sökningar inte räknas mot din månatliga kvot.

Support

Om du vill ha hjälp med den här anslutningsappen eller ditt SerpApi-konto kontaktar du SerpApi-supportteamet:

Email:contact@serpapi.com
Livechatt: Tillgänglig 24/7 på serpapi.com, där du kan tala direkt med en medlem i SerpApi-supportteamet.

Skapa en anslutning

Anslutningsappen stöder följande autentiseringstyper:


Standardinställning	Parametrar för att skapa anslutning.	Alla regioner	Går inte att dela

Standard

Tillämpligt: Alla regioner

Parametrar för att skapa anslutning.

Det här är inte delningsbar anslutning. Om power-appen delas med en annan användare uppmanas en annan användare att skapa en ny anslutning explicit.

Name	Type	Description	Obligatoriskt
API-nyckel	securestring	Din SerpApi API-nyckel. Hitta den på https://serpapi.com/manage-api-key	True

Åtgärder

Google Search	Hämta strukturerade Google Search-resultat för en viss fråga. Returnerar organiska resultat, annonser, kunskapsdiagram, relaterade frågor, toppberättelser, lokala resultat med mera.
Hämta kontoinformation	Returnerar information om det autentiserade SerpApi-kontot, inklusive planinformation, återstående sökningar och användningsstatistik.
Hämta platser	Returnerar en lista över geografiska platser som stöds och som kan användas med platsparametern i en sökning. Användbart för att hitta den exakta platssträngen för en stad eller region.

Google Search

Åtgärds-ID:: GoogleSearch

Hämta strukturerade Google Search-resultat för en viss fråga. Returnerar organiska resultat, annonser, kunskapsdiagram, relaterade frågor, toppberättelser, lokala resultat med mera.

Parametrar

Name	Nyckel	Obligatorisk	Typ	Description
Sökfråga	q	True	string	Sökfrågan. Stöder alla standardoperatorer (t.ex. site:, inurl:, intitle:) och avancerade parametrar som as_dt och as_eq.
Plats	location		string	Platsen som sökningen kommer från. Ange på stadsnivå för bästa noggrannhet (t.ex. Austin, Texas). Det går inte att använda tillsammans med parametrarna uule, lat eller lon. https://serpapi.com/locations-api Se för platser som stöds.
Kodad plats (UULE)	uule		string	Googles kodade platssträng. Använd som ett alternativ till platsparametern för exakt geoplats. Det går inte att använda tillsammans med plats, lat, lon eller radie.
Latitud	lat		number	GPS-latitud för sök ursprunget. Krävs när du använder parametern lon. Det går inte att använda tillsammans med plats eller uule.
Longitud	lon		number	GPS-longitud för sök ursprunget. Krävs när du använder lat-parametern. Det går inte att använda tillsammans med plats eller uule.
Radie (meter)	radius		integer	Avstånd i meter inom vilken fördomsfulla sökresultat. Resultaten i den här regionen rangordnas högre. Kan användas tillsammans med plats eller lat/lon. Maximal radie: 199 m på skrivbordet; 1000 m på surfplatta eller mobil. Det går inte att använda tillsammans med uule.
Google Domain	google_domain		string	Den Google-domän som ska användas (t.ex. google.com, google.co.uk, google.fr). Standardvärdet är google.com. Se https://serpapi.com/google-domains för den fullständiga listan.
Country	gl		string	Landskod med två bokstäver för sökningen (t.ex. oss, gb, fr, de). Se https://serpapi.com/google-countries för den fullständiga listan.
Språk	hl		string	Språkkod med två bokstäver (t.ex. en, es, fr, de). Se https://serpapi.com/google-languages för den fullständiga listan.
Begränsa land	cr		string	Begränsa resultatet till dokument som har sitt ursprung i specifika länder. Använd landsformatet {CODE} med \| som avgränsare (t.ex. countryFR\|countryDE).
Språkbegränsning	lr		string	Begränsa resultaten till specifika språk. Använd lang_{code}-format med \| som avgränsare (t.ex. lang_fr\|lang_de).
Avancerat sökfilter	tbs		string	Avancerat sökfilter (som ska sökas igenom). Aktiverar filtrering efter datumintervall, innehållstyp med mera (t.ex. qdr:d för den senaste dagen, qdr:w för den senaste veckan).
SafeSearch	safe		string	Nivå av filtrering av vuxet innehåll. Ställ in på aktiv för att aktivera filtrering eller inaktivera för att inaktivera den.
Exkludera automatiskt korrigerade resultat	nfpr		integer	Ange till 1 om du vill undanta resultat från automatiskt korrigerade frågor när den ursprungliga frågan är felstavad. Ange till 0 för att inkludera dem (standard).
Duplicera innehållsfilter	filter		integer	Styr filter för liknande resultat och utelämnade resultat. Ange till 1 för att aktivera (standard) eller 0 för att inaktivera.
Söktyp	tbm		string	Typen av Google-sökning som ska utföras (som ska matchas). Utelämna för en vanlig webbsökning.
Resultatförskjutning	start		integer	Sidnumreringsförskjutning. Hoppar över det angivna antalet resultat. 0 returnerar den första sidan, 10 returnerar den andra sidan osv.
Device	device		string	Enhetstypen som ska simuleras. Använd skrivbord (standard), surfplatta eller mobil.
Kringgå cache	no_cache		boolean	Ställ in på true för att framtvinga ett nytt resultat och kringgå SerpApis 1-timmars cacheminne. Cachelagrade sökningar är kostnadsfria och räknas inte mot din månatliga kvot. Använd inte tillsammans med asynkronisering.
Asynkront läge	async		boolean	Ställ in på true för att skicka sökningen och hämta resultat senare via API:et sökarkiv i stället för att vänta på resultat synkront. Använd inte tillsammans med no_cache.
Utdataformat	output		string	Utdataformat. Ange till json (standard) för strukturerad JSON eller html för rå HTML. Använd html för felsökning eller för resultattyper som ännu inte stöds fullt ut.
Placera CID	ludocid		string	Google CID (kundidentifierare) för en specifik plats. Finns i lokala resultat som place_id. Används för att hämta en plats kunskapsdiagram.
Kunskapsdiagram-ID	kgmid		string	KGMID för en Google Knowledge Graph-entitet. Kan åsidosätta andra sökparametrar förutom start.
Lokal signatur (lsig)	lsig		string	Används för att tvinga kunskapsdiagrammets kartvy för en lokal plats. Hämta via DET lokala paket-API:et eller Googles lokala API.
Cachelagrade sökparametrar (si)	si		string	Cachelagrade krypterade sökparametrar för Knowledge Graph-flikar. Kan åsidosätta andra sökparametrar förutom start.
Layoutexpansion (ibp)	ibp		string	Styr layoutexpansioner i Google-resultat (t.ex. gwp; 0,7).
Filtersträng (uds)	uds		string	Filtersträng som tillhandahålls av Google för resultatfiltrering.
Nollspårning	zero_trace		boolean	Endast företagskonton. Ställ in på true för att hoppa över lagring på serversidan av sökparametrar och metadata.

Returer

Name	Sökväg	Typ	Description
search_metadata	search_metadata	object	Metadata om sökbegäran, inklusive status, tidsinställningar och SerpApi-identifierare.
search_parameters	search_parameters	object	Parametrarna som används för den här sökningen, ekade tillbaka från begäran.
search_information	search_information	object	Information på hög nivå om sökningen, till exempel totalt resultatantal och tidsåtgång.
organic_results	organic_results	array of object	Standardresultat för organiska webbplatser som returneras av Google.
items	organic_results	object
Annonser	ads	array of object	Betalda annonser som visas ovan eller under organiska resultat.
items	ads	object
knowledge_graph	knowledge_graph	object	Google Knowledge Graph-paneldata, om de finns för frågan.
related_questions	related_questions	array of object	Personer ställer också frågor som rör frågan.
items	related_questions	object
related_searches	related_searches	array of object	Relaterade sökförslag som visas längst ned på resultatsidan.
items	related_searches	object
local_results	local_results	object	Lokala paketresultat, som visas när frågan har lokal avsikt.
top_stories	top_stories	array of object	De viktigaste nyheterna som är relaterade till frågan.
items	top_stories	object
sidnumrering	pagination	object	Länkar till nästa och föregående sidor med resultat.

Hämta kontoinformation

Åtgärds-ID:: GetAccount

Returnerar information om det autentiserade SerpApi-kontot, inklusive planinformation, återstående sökningar och användningsstatistik.

Returer

Information om det autentiserade SerpApi-kontot.

Body: AccountInfo

Hämta platser

Åtgärds-ID:: GetLocations

Returnerar en lista över geografiska platser som stöds och som kan användas med platsparametern i en sökning. Användbart för att hitta den exakta platssträngen för en stad eller region.

Parametrar

Name	Nyckel	Obligatorisk	Typ	Description
Söktermen	q		string	Ett ort- eller regionnamn för att filtrera listan över tillgängliga platser (t.ex. Austin).
Limit	limit		integer	Maximalt antal platser som ska returneras.

Returer

response: array of Location

Definitioner

Plats

En geografisk plats som stöds för användning med parametern för platssökning.

Name	Sökväg	Typ	Description
id	id	string	Unik identifierare för den här platsen.
name	name	string	Fullständigt namn på platsen (t.ex. Austin, Texas, United States).
canonical_name	canonical_name	string	Kanoniskt namn som används i platsparametern.
country_code	country_code	string	Iso-landskod med två bokstäver.
target_type	target_type	string	Typ av plats (t.ex. ort, DMA-region, land).
Nå	reach	integer	Uppskattad månatlig sökvolym för den här platsen.
Gps	gps	array of number	GPS-koordinater som [latitud, longitud].

KontoInfo (på engelska)

Information om det autentiserade SerpApi-kontot.

Name	Sökväg	Typ	Description
account_id	account_id	string	Unik identifierare för kontot.
API-nyckel	api_key	string	API-nyckeln för det här kontot.
account_email	account_email	string	E-postadress som är associerad med kontot.
plan_name	plan_name	string	Namnet på den aktuella prenumerationsplanen.
plan_monthly_price	plan_monthly_price	number	Månadspris för den aktuella planen i USD.
searches_per_month	searches_per_month	integer	Totalt antal sökningar som ingår per månad i den aktuella planen.
plan_searches_left	plan_searches_left	integer	Antal sökningar som återstår under den aktuella faktureringsperioden.
extra_credits	extra_credits	integer	Ytterligare sökkrediter som köpts utanför planen.
account_rate_limit_per_hour	account_rate_limit_per_hour	integer	Maximalt antal API-begäranden som tillåts per timme.
this_month_usage	this_month_usage	integer	Antal sökningar som använts hittills den här faktureringsperioden.
this_hour_searches	this_hour_searches	integer	Antal sökningar som gjorts under den aktuella timmen.
last_hour_searches	last_hour_searches	integer	Antal sökningar som gjorts under föregående timme.

SerpApi

SerpApi

Publisher: SerpApi

Förutsättningar

Åtgärder som stöds

Google Search (GoogleSearch)

Hämta platser (GetLocations)

Hämta kontoinformation (GetAccount)

Hämta autentiseringsuppgifter

Getting Started

Grundläggande användning

Skicka valfria parametrar

Åtkomst till svarsdata

Leta upp en giltig platssträng

Kontrollera kontoanvändning

Kända problem och begränsningar

Support

Skapa en anslutning

Standard

Åtgärder

Google Search

Parametrar

Returer

Hämta kontoinformation

Returer

Hämta platser

Parametrar

Returer

Definitioner

Plats

KontoInfo (på engelska)

Google Search (`GoogleSearch`)

Hämta platser (`GetLocations`)

Hämta kontoinformation (`GetAccount`)