SerpApi

Výsledky vyhledávacího webu v reálném čase prostřednictvím SerpApi Výstřižky Google, Bing, YouTube, Google Scholar a další bez správy proxy serverů, CAPTCHA nebo analyzátorů. SerpApi zpracovává infrastrukturu, aby vaše pracovní postupy dostávaly čistý a strukturovaný JSON.

Tento konektor je dostupný v následujících produktech a oblastech:

Service	Class	Regions
Copilot Studio	Premium	Všechny oblasti Power Automate s výjimkou následujících: – státní správa USA (GCC) – státní správa USA (GCC High) - China Cloud provozovaný společností 21Vianet - Ministerstvo obrany USA (DoD)
Logické aplikace	Standard	Všechny oblasti Logic Apps s výjimkou následujících: – Oblasti Azure Government – Oblasti Azure China - Ministerstvo obrany USA (DoD)
Power Apps	Premium	Všechny oblasti Power Apps s výjimkou následujících: – státní správa USA (GCC) – státní správa USA (GCC High) - China Cloud provozovaný společností 21Vianet - Ministerstvo obrany USA (DoD)
Automatizace napájení	Premium	Všechny oblasti Power Automate s výjimkou následujících: – státní správa USA (GCC) – státní správa USA (GCC High) - China Cloud provozovaný společností 21Vianet - Ministerstvo obrany USA (DoD)

Kontakt
Name	SerpApi
URL	https://serpapi.com
Email	support@serpapi.com

Metadata konektoru
Vydavatel	SerpApi
Internetová stránka	https://serpapi.com
Zásady ochrany osobních údajů	https://serpapi.com/legal/privacy
Kategorie	Internetová stránka; Business Intelligence

SerpApi

SerpApi je rozhraní API výsledků vyhledávacího webu v reálném čase. Zpracovává proxy servery, CAPTCHA a parsuje, aby vaše Power Apps a Power Automate toky dostávaly čistý a strukturovaný JSON bez nutnosti spravovat žádnou infrastrukturu škrábání.

Publisher: SerpApi

Předpoklady

Účet SerpApi. Zaregistrujte se na serpapi.com.
Platný klíč rozhraní API SerpApi. Plány free zahrnují 250 hledání za měsíc. Placené plány jsou k dispozici pro vyšší objem.

Podporované operace

Google Search (`GoogleSearch`)

Načtěte strukturované výsledky Hledání Google pro daný dotaz. Vrátí organické výsledky, reklamy, položky grafu znalostí, související otázky, místní výsledky, hlavní příběhy a další. Přesná vrácená pole závisí na dotazu a na tom, co pro něj Google zobrazí.

Získat umístění (`GetLocations`)

Vrátí seznam podporovaných geografických umístění, která lze předat location parametru hledání. Použijte k vyhledání přesného řetězce umístění města nebo oblasti před spuštěním hledání.

Získání informací o účtu (`GetAccount`)

Vrátí informace o vašem účtu SerpApi, včetně aktuálního plánu, měsíční kvóty vyhledávání, zbývajících hledání a statistik využití po hodinách.

Získání přihlašovacích údajů

Přihlaste se ke svému účtu SerpApi na serpapi.com.
Přejděte na serpapi.com/manage-api-key.
Zkopírujte klíč rozhraní API.
Při vytváření připojení v Power Apps nebo Power Automate vložte klíč rozhraní API do pole Klíč rozhraní API.

Klíč rozhraní API je bezpečně uložený platformou Power Platform a automaticky se vloží do každého požadavku. Po nastavení připojení ho nebudete muset znovu zadat.

Začínáme

Základní použití

Akce GoogleSearch provede jeden povinný argument (vyhledávací dotaz) a volitelný záznam dalších parametrů:

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

Zobrazení nezpracované odpovědi JSON v ovládacím prvku text HTML pro ladění:

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

Předávání volitelných parametrů

Volitelné parametry se předávají jako záznam (druhý argument). Zahrňte pouze parametry, které chcete nastavit – vynecháním klíče se pro tento parametr nic neposílá, takže SerpApi použije vlastní výchozí hodnotu.

V následujícím příkladu jsou vstupní typy a názvy doporučení, nikoli povinné.

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

Mapování typů ovládacích prvků:

Typ parametru	Doporučený ovládací prvek Power Apps	Referenční informace k hodnotě
Text (řetězec)	Textové zadání	`controlName.Text`
logický	Přepnutí nebo zaškrtávací políčko	`controlName.Value`
Výčet (pevné možnosti)	Rozevírací nabídka	`controlName.Selected.Value`
Number	Textové zadání	`controlName.Text`

Přístup k datům odpovědi

Odpověď je objekt JSON. Přístup k vlastnostem nejvyšší úrovně přímo z proměnné:

varJsonResponse.search_information.total_results

Vytvoření vazby galerie k organickým výsledkům:

varJsonResponse.organic_results

Vytvoření vazby galerie k místním obchodním výsledkům:

varJsonResponse.local_results.places

Úplný seznam polí odpovědí najdete v dokumentaci k Vyhledávání Google v SerpApi .

Vyhledání platného řetězce umístění

Slouží GetLocations k vyhledání přesného názvu umístění, do které se má GoogleSearchpředat . Parametr q filtruje podle názvu města nebo oblasti a limit limituje počet vrácených výsledků.

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

Vytvoření vazby výsledků k galerii:

varLocations

Každá položka v kolekci obsahuje name, , canonical_namecountry_codetarget_type, , reach, a gps pole. canonical_name Předejte hodnotu jako location parametr v následném GoogleSearch volání:

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

Kontrola využití účtu

Slouží GetAccount k načtení podrobností o aktuálním plánu a využití kvóty. To je užitečné při kontrole počtu hledání, než dosáhnete svého měsíčního limitu.

Set(varAccount, SerpApi.GetAccount())

Přístup k jednotlivým polím z odpovědi:

varAccount.plan_searches_left
varAccount.this_month_usage
varAccount.account_rate_limit_per_hour

Úplný seznam polí odpovědí najdete v dokumentaci k rozhraní API účtu SerpApi .

Známé problémy a omezení

Struktura odpovědi proměnné: Pole obsažená v odpovědi Google Search závisí na dotazu a na tom, co google vrátí. V každé odpovědi se nezobrazují všechna pole. Úplný popis možných polí odpovědí najdete v dokumentaci k Vyhledávání Google v SerpApi .
Omezení rychlosti: Požadavky podléhají měsíční kvótě plánu SerpApi a hodinovému limitu sazby. Překročení obou výsledků způsobí chybovou 429 odpověď.
Výsledky uložené v mezipaměti: Ve výchozím nastavení poskytuje SerpApi výsledky z mezipaměti pro duplicitní požadavky specifické pro každého uživatele (až 1 hodinu staré). no_cache Použijte parametr k vynucení nového výsledku. Všimněte si, že hledání v mezipaměti se nezapočítávají do měsíční kvóty.

Support

Pokud potřebujete pomoc s tímto konektorem nebo účtem SerpApi, obraťte se na tým podpory SerpApi:

Email:contact@serpapi.com
Živý chat: K dispozici 24/7 na serpapi.com, kde můžete mluvit přímo s členem týmu podpory SerpApi.

Vytvoření připojení

Konektor podporuje následující typy ověřování:


Default	Parametry pro vytvoření připojení	Všechny oblasti	Nesdílitelné

Výchozí

Použitelné: Všechny oblasti

Parametry pro vytvoření připojení

Toto připojení není možné sdílet. Pokud se power app sdílí s jiným uživatelem, zobrazí se výzva k explicitní vytvoření nového připojení.

Name	Typ	Description	Povinné
Klíč API	securestring	Váš klíč rozhraní API SerpApi. Najít na adrese https://serpapi.com/manage-api-key	Pravdivé

Akce

Google Search	Načtěte strukturované výsledky Hledání Google pro daný dotaz. Vrátí organické výsledky, reklamy, graf znalostí, související otázky, hlavní příběhy, místní výsledky a další.
Získání informací o účtu	Vrátí informace o ověřeném účtu SerpApi, včetně podrobností plánu, zbývajících hledání a statistik využití.
Získání umístění	Vrátí seznam podporovaných geografických umístění, která lze použít s parametrem umístění ve vyhledávání. Užitečné pro vyhledání přesného řetězce umístění pro město nebo oblast.

Google Search

ID operace:: GoogleSearch

Načtěte strukturované výsledky Hledání Google pro daný dotaz. Vrátí organické výsledky, reklamy, graf znalostí, související otázky, hlavní příběhy, místní výsledky a další.

Parametry

Name	Klíč	Vyžadováno	Typ	Description
Vyhledávací dotaz	q	True	string	Vyhledávací dotaz. Podporuje všechny standardní operátory (např. site:, inurl:, intitle:) a pokročilé parametry, jako jsou as_dt a as_eq.
Umístění	location		string	Umístění, ze kterého vyhledávání pochází. Zadejte na úrovni města pro nejlepší přesnost (např. Austin, Texas). Nelze použít společně s parametry uule, lat nebo lon. Projděte si https://serpapi.com/locations-api podporovaná umístění.
Zakódované umístění (UULE)	uule		string	Řetězec umístění zakódovaný googlem. Použijte jako alternativu parametru umístění pro přesnou geografickou polohu. Nelze použít společně s umístěním, západkou,lonem nebo poloměrem.
Zeměpisná šířka	lat		number	GPS zeměpisná šířka pro původ hledání. Vyžaduje se při použití parametru lon. Nelze použít společně s umístěním nebo uule.
Zeměpisná délka	lon		number	Zeměpisná délka GPS pro původ hledání. Vyžaduje se při použití parametru lat. Nelze použít společně s umístěním nebo uule.
Poloměr (metry)	radius		integer	Vzdálenost v metrech, ve kterých se mají předsunout výsledky hledání. Výsledky v této oblasti jsou seřazené výš. Lze použít spolu s umístěním nebo lat/lonem. Maximální poloměr: 199 m na ploše; 1000 m na tabletu nebo mobilním zařízení. Nelze použít společně s uule.
Doména Google	google_domain		string	Doména Google, která se má použít (např. google.com, google.co.uk, google.fr). Výchozí hodnota je google.com. Podívejte se https://serpapi.com/google-domains na úplný seznam.
Country	gl		string	Dvoumístný kód země pro vyhledávání (např. us, gb, fr, de). Podívejte se https://serpapi.com/google-countries na úplný seznam.
Jazyk	hl		string	Dvoumístný kód jazyka rozhraní (např. en, es, fr, de). Podívejte se https://serpapi.com/google-languages na úplný seznam.
Omezení země	cr		string	Omezit výsledky na dokumenty pocházející z konkrétních zemí. Použít formát země{CODE} s \| jako oddělovač (např. countryFR\|countryDE).
Omezení jazyka	lr		string	Omezte výsledky na konkrétní jazyky. Použití formátu lang_{code} s \| jako oddělovač (např. lang_fr\|lang_de).
Rozšířený filtr vyhledávání	tbs		string	Rozšířený filtr vyhledávání (který se má prohledávat). Umožňuje filtrování podle rozsahu kalendářních dat, typu obsahu a dalších položek (např. qdr:d za poslední den, qdr:w za minulý týden).
Bezpečné hledání	safe		string	Úroveň filtrování obsahu pro dospělé Nastavením na aktivní povolíte filtrování nebo ho vypnete.
Vyloučit automaticky opravené výsledky	nfpr		integer	Pokud chcete vyloučit výsledky z automaticky opravovaných dotazů, pokud je původní dotaz nesprávně napsaný, nastavte na hodnotu 1. Pokud je chcete zahrnout na hodnotu 0 (výchozí).
Duplicitní filtr obsahu	filter		integer	Řídí podobné výsledky a vynechané filtry výsledků. Nastavte na 1, pokud chcete povolit (výchozí) nebo 0 zakázat.
Typ hledání	tbm		string	Typ vyhledávání Google, který se má provést (aby se shodoval). Vynechání běžného vyhledávání na webu.
Posun výsledku	start		integer	Posun stránkování Přeskočí zadaný počet výsledků. 0 vrátí první stránku, 10 vrátí druhou stránku atd.
Device	device		string	Typ zařízení, který se má simulovat. Používejte desktop (výchozí), tablet nebo mobilní zařízení.
Obejití mezipaměti	no_cache		boolean	Nastavte hodnotu true tak, aby vynutil nový výsledek a vynechal 1hodinovou mezipaměť SerpApi. Hledání v mezipaměti jsou bezplatná a nezapočítávají se do měsíční kvóty. Nepoužívejte společně s asynchronními funkcemi.
Asynchronní režim	async		boolean	Pokud chcete výsledky odeslat a načíst výsledky později přes rozhraní API archivu vyhledávání, nastavte hodnotu true a nečekejte na výsledky synchronně. Nepoužívejte společně s no_cache.
Výstupní formát	output		string	Výstupní formát Nastavte na json (výchozí) pro strukturovaný kód JSON nebo html pro nezpracovaný kód HTML. Pro ladění nebo pro typy výsledků, které ještě nejsou plně podporované, použijte html.
Umístit identifikátor CID	ludocid		string	Identifikátor CID Google (identifikátor zákazníka) konkrétního místa. Nachází se v místních výsledcích jako place_id. Používá se k načtení znalostního grafu místa.
ID znalostního grafu	kgmid		string	KGMID entity Google Knowledge Graph. Může přepsat další parametry hledání kromě spuštění.
Místní podpis (lsig)	lsig		string	Slouží k vynucení zobrazení mapy grafu znalostí pro místní místo. Získejte ho prostřednictvím rozhraní API místního balíčku nebo rozhraní Google Local API.
Parametry hledání v mezipaměti (si)	si		string	Šifrované parametry hledání uložené v mezipaměti pro karty Znalostní grafy Může přepsat další parametry hledání kromě spuštění.
Rozšíření rozložení (ibp)	ibp		string	Řídí rozšíření rozložení ve výsledcích Google (např. gwp; 0,7).
Filtrovací řetězec (uds)	uds		string	Řetězec filtru zadaný googlem pro filtrování výsledků
Nulové trasování	zero_trace		boolean	Jenom podnikové účty. Pokud chcete přeskočit úložiště parametrů hledání a metadat na straně serveru, nastavte na hodnotu true.

Návraty

Name	Cesta	Typ	Description
search_metadata	search_metadata	object	Metadata žádosti o vyhledávání, včetně identifikátorů stavu, časování a SerpApi.
search_parameters	search_parameters	object	Parametry použité pro toto hledání se vrátily z požadavku.
search_information	search_information	object	Obecné informace o hledání, jako je celkový počet výsledků a doba potřebná.
organic_results	organic_results	array of object	Standardní organické webové výsledky vrácené Googlem.
items	organic_results	object
Reklamy	ads	array of object	Placené reklamy zobrazené nad nebo pod organickými výsledky.
items	ads	object
knowledge_graph	knowledge_graph	object	Data panelu Google Knowledge Graph, pokud jsou k dispozici pro dotaz.
related_questions	related_questions	array of object	Lidé také ptají na dotazy související s dotazem.
items	related_questions	object
related_searches	related_searches	array of object	Související návrhy hledání zobrazené v dolní části stránky výsledků
items	related_searches	object
local_results	local_results	object	Výsledky místní sady, které jsou přítomné, když má dotaz místní záměr.
top_stories	top_stories	array of object	Hlavní zprávy související s dotazem
items	top_stories	object
stránkování	pagination	object	Odkazuje na další a předchozí stránky výsledků.

Získání informací o účtu

ID operace:: GetAccount

Vrátí informace o ověřeném účtu SerpApi, včetně podrobností plánu, zbývajících hledání a statistik využití.

Návraty

Informace o ověřeném účtu SerpApi

Body: AccountInfo

Získání umístění

ID operace:: GetLocations

Vrátí seznam podporovaných geografických umístění, která lze použít s parametrem umístění ve vyhledávání. Užitečné pro vyhledání přesného řetězce umístění pro město nebo oblast.

Parametry

Name	Klíč	Vyžadováno	Typ	Description
Hledaný termín	q		string	Název města nebo oblasti pro filtrování seznamu dostupných umístění (např. Austin).
Limit	limit		integer	Maximální počet umístění, která se mají vrátit.

Návraty

response: array of Location

Definice

Umístění

Podporované geografické umístění pro použití s parametrem hledání polohy.

Name	Cesta	Typ	Description
id	id	string	Jedinečný identifikátor pro toto umístění.
název	name	string	Úplný název umístění (např. Austin, Texas, USA).
canonical_name	canonical_name	string	Kanonický název použitý v parametru umístění.
country_code	country_code	string	Dvoumísmenný kód země ISO.
target_type	target_type	string	Typ umístění (např. City, DMA Region, Country).
Reach	reach	integer	Odhadovaný měsíční objem hledání se pro toto umístění dosáhne.
Gps	gps	array of number	Souřadnice GPS jako [zeměpisná šířka, zeměpisná délka].

Informace o účtu

Informace o ověřeném účtu SerpApi

Name	Cesta	Typ	Description
account_id	account_id	string	Jedinečný identifikátor účtu.
klíč API	api_key	string	Klíč rozhraní API pro tento účet.
account_email	account_email	string	E-mailová adresa přidružená k účtu
plan_name	plan_name	string	Název aktuálního plánu předplatného
plan_monthly_price	plan_monthly_price	number	Měsíční cena aktuálního plánu v USD.
searches_per_month	searches_per_month	integer	Celkový počet hledání zahrnutých za měsíc v aktuálním plánu
plan_searches_left	plan_searches_left	integer	Počet hledání zbývajících v aktuálním fakturačním období
extra_credits	extra_credits	integer	Další kredity vyhledávání zakoupené mimo plán
account_rate_limit_per_hour	account_rate_limit_per_hour	integer	Maximální počet požadavků rozhraní API povolených za hodinu
this_month_usage	this_month_usage	integer	Počet dosud použitých hledání v tomto fakturačním období
this_hour_searches	this_hour_searches	integer	Počet hledání provedených v aktuální hodině
last_hour_searches	last_hour_searches	integer	Počet hledání provedených v předchozí hodině

SerpApi

SerpApi

Publisher: SerpApi

Předpoklady

Podporované operace

Google Search (GoogleSearch)

Získat umístění (GetLocations)

Získání informací o účtu (GetAccount)

Získání přihlašovacích údajů

Začínáme

Základní použití

Předávání volitelných parametrů

Přístup k datům odpovědi

Vyhledání platného řetězce umístění

Kontrola využití účtu

Známé problémy a omezení

Support

Vytvoření připojení

Výchozí

Akce

Google Search

Parametry

Návraty

Získání informací o účtu

Návraty

Získání umístění

Parametry

Návraty

Definice

Umístění

Informace o účtu

Google Search (`GoogleSearch`)

Získat umístění (`GetLocations`)

Získání informací o účtu (`GetAccount`)