SerpApi

Valós idejű keresőmotor-eredmények a SerpApi használatával. Kaparja le a Google, a Bing, a YouTube, a Google Tudós és egyebeket a proxyk, CAPTCHA-k vagy elemzők kezelése nélkül. A SerpApi kezeli az infrastruktúrát, így a munkafolyamatok tiszta, strukturált JSON-t kapnak.

Ez az összekötő a következő termékekben és régiókban érhető el:

Service	Class	Régiók
Copilot Studio	prémium	Az összes Power Automate-régió, kivéve a következőket: - USA kormánya (GCC) - Amerikai kormány (GCC High) - A 21Vianet által üzemeltetett China Cloud - Amerikai Védelmi Minisztérium (DoD)
Logikai alkalmazások	Standard	Az összes Logic Apps-régió , kivéve a következőket: - Azure Government-régiók - Azure China-régiók - Amerikai Védelmi Minisztérium (DoD)
Power Apps	prémium	Az összes Power Apps-régió , kivéve a következőket: - USA kormánya (GCC) - Amerikai kormány (GCC High) - A 21Vianet által üzemeltetett China Cloud - Amerikai Védelmi Minisztérium (DoD)
Power Automate	prémium	Az összes Power Automate-régió, kivéve a következőket: - USA kormánya (GCC) - Amerikai kormány (GCC High) - A 21Vianet által üzemeltetett China Cloud - Amerikai Védelmi Minisztérium (DoD)

Kapcsolat
Név	SerpApi
URL	https://serpapi.com
Email	support@serpapi.com

Összekötő metaadatai
Publisher	SerpApi
Webhely	https://serpapi.com
Adatvédelmi irányelvek	https://serpapi.com/legal/privacy
Categories	Webhely; Üzleti intelligencia

SerpApi

A SerpApi egy valós idejű keresőmotor-találati API. Proxykat, CAPTCHA-kat és elemzéseket kezel, így a Power Apps és Power Automate folyamatok tiszta, strukturált JSON-t kapnak anélkül, hogy bármilyen kaparási infrastruktúrát kezelnek.

Publisher: SerpApi

Prerequisites

Egy SerpApi-fiók. Regisztráljon a serpapi.com.
Érvényes SerpApi API-kulcs. Az ingyenes csomagok havi 250 keresést tartalmaznak. A fizetős csomagok nagyobb mennyiségben érhetők el.

Támogatott műveletek

Google Search (`GoogleSearch`)

Egy adott lekérdezés strukturált Google Search-találatainak lekérése. Organikus eredményeket, hirdetéseket, tudásgráf-bejegyzéseket, kapcsolódó kérdéseket, helyi eredményeket, top történeteket és egyebeket ad vissza. A visszaadott pontos mezők a lekérdezéstől és a Google által használt felületektől függenek.

Helyek lekérése (`GetLocations`)

A támogatott földrajzi helyek listáját adja vissza, amelyek átadhatók a location keresés paraméterének. Ezzel megkeresheti egy város vagy régió pontos helysztringét a keresés futtatása előtt.

Fiókadatok lekérése (`GetAccount`)

Adatokat ad vissza a SerpApi-fiókjáról, beleértve az aktuális csomagot, a havi keresési kvótát, a fennmaradó kereséseket és az óránkénti használati statisztikákat.

Hitelesítő adatok beszerzése

Jelentkezzen be SerpApi-fiókjába a serpapi.com.
Lépjen a serpapi.com/manage-api-key.
Másolja ki az API-kulcsot.
Amikor kapcsolatot hoz létre Power Apps vagy Power Automate, illessze be az API-kulcsot az API-kulcs mezőbe.

Az API-kulcsot a Power Platform biztonságosan tárolja, és minden kérésbe automatikusan injektálja. A kapcsolat beállítása után nem kell újból megadnia.

Első lépések

Alapszintű használat

A GoogleSearch művelet egy kötelező argumentumot (keresési lekérdezést) és további paraméterek opcionális rekordját használja:

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

Ha a nyers JSON-választ egy HTML-szövegvezérlőben szeretné megjeleníteni a hibakereséshez:

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

Választható paraméterek átadása

Az opcionális paramétereket a rendszer rekordként adja át (a második argumentum). Csak a beállítani kívánt paramétereket foglalja bele – ha kihagy egy kulcsot, az nem küld semmit az adott paraméterhez, így a SerpApi saját alapértelmezett értéket használ.

Az alábbi példában a bemeneti típusok és nevek javaslatok, nem kötelezőek.

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

Vezérlőtípus-megfeleltetés:

Paraméter típusa	Ajánlott Power Apps vezérlőelem	Értékhivatkozás
Szöveg (karakterlánc)	Szövegbevitel	`controlName.Text`
logikai	Váltás vagy jelölőnégyzet	`controlName.Value`
Enum (rögzített beállítások)	Legördülő	`controlName.Selected.Value`
Szám	Szövegbevitel	`controlName.Text`

Válaszadatok elérése

A válasz egy JSON-objektum. A legfelső szintű tulajdonságok közvetlenül a változóból érhetők el:

varJsonResponse.search_information.total_results

Katalógus kötése az organikus eredményekhez:

varJsonResponse.organic_results

Katalógus helyi üzleti eredményekhez kötése:

varJsonResponse.local_results.places

A válaszmezők teljes listáját a SerpApi Google Search dokumentációjában találja.

Érvényes hely sztring keresése

A pontos helynév megkeresésére GetLocationshasználhatóGoogleSearch. A q paraméter város vagy régiónév szerint szűr, és limit a visszaadott eredmények számát korlátozza.

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

Az eredmények katalógushoz kötése:

varLocations

A gyűjtemény nameminden eleme tartalmaz , canonical_name, country_code, target_type, reachés gps mezőket. Adja át az canonical_name értéket paraméterként location egy későbbi GoogleSearch hívásban:

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

Fiókhasználat ellenőrzése

Az aktuális csomag részleteinek és a kvótahasználatnak a lekérésére használható GetAccount . Ez hasznos annak ellenőrzéséhez, hogy hány keresés maradjon meg, mielőtt eléri a havi korlátot.

Set(varAccount, SerpApi.GetAccount())

Az egyes mezők elérése a válaszból:

varAccount.plan_searches_left
varAccount.this_month_usage
varAccount.account_rate_limit_per_hour

A válaszmezők teljes listájához tekintse meg a SerpApi Account API dokumentációját .

Ismert problémák és korlátozások

Változó válaszstruktúra: A Google Search-válaszban található mezők a lekérdezéstől és a Google által visszaadott adatoktól függenek. Nem minden mező jelenik meg minden válaszban. A lehetséges válaszmezők teljes leírását a SerpApi Google Search dokumentációjában találja.
Díjkorlátok: A kérelmekre a SerpApi-csomag havi kvótája és óradíjkorlátja vonatkozik. Ha valamelyiket túllépi, az hibaválaszt 429 eredményez.
Gyorsítótárazott eredmények: Alapértelmezés szerint a SerpApi az egyes felhasználókra (legfeljebb 1 órás) vonatkozó ismétlődő kérések gyorsítótárából származó eredményeket szolgáltatja. A paraméterrel no_cache kényszerítse ki a friss eredményt. Vegye figyelembe, hogy a gyorsítótárazott keresések nem számítanak bele a havi kvótába.

Support

Az összekötővel vagy a SerpApi-fiókkal kapcsolatos segítségért forduljon a SerpApi támogatási csapatához:

Email:contact@serpapi.com
Élő csevegés: 24/7-kor érhető el serpapi.com, ahol közvetlenül a SerpApi támogatási csapatának egyik tagjával beszélhet.

Kapcsolat létrehozása

Az összekötő a következő hitelesítési típusokat támogatja:


Alapértelmezett	A kapcsolat létrehozásának paraméterei.	Minden régió	Nem osztható meg

Alapértelmezett

Alkalmazható: Minden régió

A kapcsolat létrehozásának paraméterei.

Ez nem megosztható kapcsolat. Ha a power app meg van osztva egy másik felhasználóval, a rendszer kérni fogja, hogy hozzon létre új kapcsolatot.

Név	Típus	Description	Required
API-kulcs	securestring	A SerpApi API-kulcs. Keresse meg a https://serpapi.com/manage-api-key	True

Műveletek

Fiókadatok lekérése	A hitelesített SerpApi-fiók adatait adja vissza, beleértve a terv részleteit, a fennmaradó kereséseket és a használati statisztikákat.
Google Search	Egy adott lekérdezés strukturált Google Search-találatainak lekérése. Organikus eredményeket, hirdetéseket, tudásgráfot, kapcsolódó kérdéseket, top történeteket, helyi eredményeket és egyebeket ad vissza.
Helyek lekérése	A támogatott földrajzi helyek listáját adja vissza, amelyek a keresés helyparaméterével használhatók. Egy város vagy régió pontos helysztringjének megkereséséhez hasznos.

Fiókadatok lekérése

Műveletazonosító:: GetAccount

A hitelesített SerpApi-fiók adatait adja vissza, beleértve a terv részleteit, a fennmaradó kereséseket és a használati statisztikákat.

Válaszok

Információk a hitelesített SerpApi-fiókról.

Törzs: AccountInfo

Google Search

Műveletazonosító:: GoogleSearch

Egy adott lekérdezés strukturált Google Search-találatainak lekérése. Organikus eredményeket, hirdetéseket, tudásgráfot, kapcsolódó kérdéseket, top történeteket, helyi eredményeket és egyebeket ad vissza.

Paraméterek

Name	Kulcs	Kötelező	Típus	Description
Keresési lekérdezés	q	True	string	A keresési lekérdezés. Támogatja az összes standard operátort (pl. site:, inurl:, intitle:) és speciális paramétereket, például as_dt és as_eq.
Elhelyezkedés	location		string	A hely, ahonnan a keresés származik. Adja meg városi szinten a legjobb pontosság érdekében (pl. Austin, Texas). Uule, lat vagy lon paraméterekkel együtt nem használható. Tekintse meg https://serpapi.com/locations-api a támogatott helyeket.
Kódolt hely (UULE)	uule		string	A Google kódolt hely sztringje. Használja a helyparaméter alternatívaként a pontos földrajzi helymeghatározáshoz. Hely, lat, lon vagy sugár együtt nem használható.
Szélesség	lat		number	A keresés forrásának GPS szélessége. A lon paraméter használatakor szükséges. Hely vagy uule együtt nem használható.
Hosszúság	lon		number	GPS-hosszúság a keresési forráshoz. A lat paraméter használatakor kötelező. Hely vagy uule együtt nem használható.
Sugár (méter)	radius		integer	Távolság méterben, amelyen belül elfogult keresési eredmények. A régión belüli eredmények rangsorolása magasabb. A hely vagy a lat/lon mellett is használható. Maximális sugár: 199 m asztali; 1000 m táblagépen vagy mobilon. A uule-vel együtt nem használható.
Google Domain	google_domain		string	A használni kívánt Google-tartomány (például google.com, google.co.uk, google.fr). Alapértelmezés szerint google.com. Tekintse meg https://serpapi.com/google-domains a teljes listát.
Country	gl		string	A keresés kétbetűs országkódja (pl. us, gb, fr, de). Tekintse meg https://serpapi.com/google-countries a teljes listát.
Nyelv	hl		string	Kétbetűs felületi nyelvi kód (pl. en, es, fr, de). Tekintse meg https://serpapi.com/google-languages a teljes listát.
Országkorlátozás	cr		string	Az eredmények korlátozása adott országokból származó dokumentumokra. Country{CODE} formátum használata a következővel: \| elválasztóként (például countryFR\|countryDE).
Nyelvi korlátozás	lr		string	Az eredmények korlátozása adott nyelvekre. Lang_{code} formátum használata a következővel: \| elválasztóként (például lang_fr\|lang_de).
Speciális keresési szűrő	tbs		string	Speciális keresési szűrő (keresendő). Lehetővé teszi a szűrést dátumtartomány, tartalomtípus és egyebek szerint (például qdr:d az elmúlt napra, qdr:w az elmúlt hétre).
Biztonságos keresés	safe		string	Felnőtt tartalomszűrés szintje. A szűrés engedélyezéséhez vagy letiltásához állítsa be az aktív beállítást.
Automatikusan javított eredmények kizárása	nfpr		integer	Állítsa 1 értékre az automatikusan javított lekérdezések eredményeinek kizárásához, ha az eredeti lekérdezés helytelenül lett beírva. Állítsa be a 0 értéket a belefoglalásukhoz (alapértelmezett).
Ismétlődő tartalomszűrő	filter		integer	Hasonló eredmények és kihagyott eredmények szűrőit szabályozza. Állítsa be az 1 értéket a letiltás engedélyezéséhez (alapértelmezett) vagy a 0 értékre.
Keresés típusa	tbm		string	A végrehajtandó (egyeztetendő) Google-keresés típusa. Kihagyja a rendszeres webes keresést.
Eredmény eltolása	start		integer	Lapozás eltolása. Kihagyja a megadott számú találatot. 0 az első oldalt adja vissza, 10 a második oldalt stb.
Device	device		string	A szimulálni kívánt eszköztípus. Asztali (alapértelmezett), táblagép vagy mobileszközök használata.
Gyorsítótár megkerülése	no_cache		boolean	Állítsa igaz értékre, hogy új eredményt kényszerítsen ki, elkerülve SerpApi 1 órás gyorsítótárát. A gyorsítótárazott keresések ingyenesek, és nem számítanak bele a havi kvótába. Ne használja együtt az aszinkronnal.
Aszinkron mód	async		boolean	Állítsa igaz értékre a keresés elküldéséhez és a találatok későbbi lekéréséhez a Keresési archívum API-val, ahelyett, hogy szinkron módon vár a találatokra. Ne használja együtt a no_cache.
Kimeneti formátum	output		string	Kimeneti formátum. A json (alapértelmezett) értékre van állítva strukturált JSON esetén, vagy html a nyers HTML-hez. Használjon html-t hibakereséshez vagy olyan eredménytípusokhoz, amelyek még nem támogatottak teljes mértékben.
CID elhelyezése	ludocid		string	Google CID (ügyfélazonosító) egy adott helyről. A helyi eredményekben place_id. Egy hely tudásgráfjának lekérésére szolgál.
Knowledge Graph-azonosító	kgmid		string	Egy Google Knowledge Graph-entitás KGMID-je. Az indítás kivételével felülbírálhatja a többi keresési paramétert.
Helyi aláírás (lsig)	lsig		string	A tudásgráf térképnézetének kényszerítésére szolgál egy helyi hely számára. Szerezze be a Local Pack API-val vagy a Google Local API-val.
Gyorsítótárazott keresési paraméterek (si)	si		string	Gyorsítótárazott titkosított keresési paraméterek a Knowledge Graph-lapokhoz. Az indítás kivételével felülbírálhatja a többi keresési paramétert.
Elrendezésbővítés (ibp)	ibp		string	Szabályozza az elrendezésbővítéseket a Google-eredményekben (pl. 0,7).
Sztring szűrése (uds)	uds		string	Google által biztosított szűrősztring az eredményszűréshez.
Nulla nyomkövetés	zero_trace		boolean	Csak vállalati fiókok. Állítsa igaz értékre a keresési paraméterek és metaadatok kiszolgálóoldali tárolásának kihagyásához.

Válaszok

Name	Elérési út	Típus	Description
search_metadata	search_metadata	object	A keresési kérelem metaadatai, beleértve az állapotot, az időzítést és a SerpApi-azonosítókat.
search_parameters	search_parameters	object	A kereséshez használt paraméterek visszakértek a kérésből.
search_information	search_information	object	A kereséssel kapcsolatos magas szintű információk, például a teljes találatok száma és az eltelt idő.
organic_results	organic_results	array of object	A Google által visszaadott standard organikus webes eredmények.
items	organic_results	object
Hirdetések	ads	array of object	Az organikus eredmények felett vagy alatt megjelenített fizetett hirdetések.
items	ads	object
knowledge_graph	knowledge_graph	object	A Google Knowledge Graph panel adatai, ha vannak a lekérdezéshez.
related_questions	related_questions	array of object	A felhasználók a lekérdezéssel kapcsolatos kérdéseket is feltenek.
items	related_questions	object
related_searches	related_searches	array of object	Kapcsolódó keresési javaslatok a találati oldal alján.
items	related_searches	object
local_results	local_results	object	A helyi csomagok eredményei akkor jelenik meg, ha a lekérdezés helyi szándékkal rendelkezik.
top_stories	top_stories	array of object	A lekérdezéssel kapcsolatos legfontosabb hírek.
items	top_stories	object
lapszámozás	pagination	object	A következő és az előző találati lapra mutató hivatkozások.

Helyek lekérése

Műveletazonosító:: GetLocations

A támogatott földrajzi helyek listáját adja vissza, amelyek a keresés helyparaméterével használhatók. Egy város vagy régió pontos helysztringjének megkereséséhez hasznos.

Paraméterek

Name	Kulcs	Kötelező	Típus	Description
Keresési kifejezés	q		string	Egy város vagy régió neve az elérhető helyek (például Austin) listájának szűréséhez.
Limit	limit		integer	A visszaadni kívánt helyek maximális száma.

Válaszok

response: array of Location

Definíciók

Elhelyezkedés

Támogatott földrajzi hely a helykeresési paraméterrel való használatra.

Name	Elérési út	Típus	Description
id	id	string	A hely egyedi azonosítója.
név	name	string	A hely teljes neve (például Austin, Texas, Egyesült Államok).
canonical_name	canonical_name	string	A helyparaméterben használt canonical név.
country_code	country_code	string	Kétbetűs ISO-országkód.
target_type	target_type	string	A hely típusa (pl. Város, DMA régió, ország).
elérés	reach	integer	A keresési mennyiség becsült havi elérése ehhez a helyhez.
Gps	gps	array of number	A GPS koordinátái [szélesség, hosszúság].

Fiók információ

Információk a hitelesített SerpApi-fiókról.

Name	Elérési út	Típus	Description
account_id	account_id	string	A fiók egyedi azonosítója.
API kulcs	api_key	string	A fiók API-kulcsa.
account_email	account_email	string	A fiókhoz társított e-mail-cím.
plan_name	plan_name	string	Az aktuális előfizetési csomag neve.
plan_monthly_price	plan_monthly_price	number	Az aktuális csomag havi ára USD-ben.
searches_per_month	searches_per_month	integer	Az aktuális csomagban havonta szereplő keresések teljes száma.
plan_searches_left	plan_searches_left	integer	Az aktuális számlázási időszakban fennmaradó keresések száma.
extra_credits	extra_credits	integer	A csomagon kívül vásárolt további keresési kreditek.
account_rate_limit_per_hour	account_rate_limit_per_hour	integer	Óránként engedélyezett API-kérések maximális száma.
this_month_usage	this_month_usage	integer	Az eddig használt keresések száma ebben a számlázási időszakban.
this_hour_searches	this_hour_searches	integer	Az aktuális órában végrehajtott keresések száma.
last_hour_searches	last_hour_searches	integer	Az előző órában végrehajtott keresések száma.

SerpApi

SerpApi

Publisher: SerpApi

Prerequisites

Támogatott műveletek

Google Search (GoogleSearch)

Helyek lekérése (GetLocations)

Fiókadatok lekérése (GetAccount)

Hitelesítő adatok beszerzése

Első lépések

Alapszintű használat

Választható paraméterek átadása

Válaszadatok elérése

Érvényes hely sztring keresése

Fiókhasználat ellenőrzése

Ismert problémák és korlátozások

Support

Kapcsolat létrehozása

Alapértelmezett

Műveletek

Fiókadatok lekérése

Válaszok

Google Search

Paraméterek

Válaszok

Helyek lekérése

Paraméterek

Válaszok

Definíciók

Elhelyezkedés

Fiók információ

Google Search (`GoogleSearch`)

Helyek lekérése (`GetLocations`)

Fiókadatok lekérése (`GetAccount`)