SerpApi

Dieser Connector ist in den folgenden Produkten und Regionen verfügbar:

Service	Class	Regions
Copilot Studio	Premium	Alle Power Automate-Regionen mit Ausnahme der folgenden Bereiche:      - US Government (GCC)      - US Government (GCC High)      - China Cloud betrieben von 21Vianet      - US Department of Defense (DoD)
Logik-Apps	Standard	Alle Logik-Apps-Regionen mit Ausnahme der folgenden Bereiche:      – Azure Government-Regionen      - Azure China-Regionen      - US Department of Defense (DoD)
Power Apps	Premium	Alle Power Apps-Regionen mit Ausnahme der folgenden:      - US Government (GCC)      - US Government (GCC High)      - China Cloud betrieben von 21Vianet      - US Department of Defense (DoD)
Power Automate	Premium	Alle Power Automate-Regionen mit Ausnahme der folgenden Bereiche:      - US Government (GCC)      - US Government (GCC High)      - China Cloud betrieben von 21Vianet      - US Department of Defense (DoD)

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

Connectormetadaten
Herausgeber	SerpApi
Website	https://serpapi.com
Datenschutzrichtlinie	https://serpapi.com/legal/privacy
Kategorien	Website; Business Intelligence

SerpApi

SerpApi ist eine Suchergebnisse-API in Echtzeit. Es behandelt Proxys, CAPTCHAs und analysieren, damit Ihre Power Apps und Power Automate Flüsse saubere, strukturierte JSON-Daten erhalten, ohne eine Scraping-Infrastruktur zu verwalten.

Publisher: SerpApi

Voraussetzungen

• Ein SerpApi-Konto. Melden Sie sich bei serpapi.com an.
• Ein gültiger SerpApi-API-Schlüssel. Kostenlose Pläne umfassen 250 Suchvorgänge pro Monat. Kostenpflichtige Pläne sind für ein höheres Volumen verfügbar.

Unterstützte Vorgänge

Google Search (GoogleSearch)

Rufen Sie strukturierte Google Search-Ergebnisse für eine bestimmte Abfrage ab. Gibt organische Ergebnisse, Anzeigen, Wissensdiagrammeinträge, verwandte Fragen, lokale Ergebnisse, Top-Stories und mehr zurück. Die zurückgegebenen genauen Felder hängen von der Abfrage ab und davon, welche Google-Felder dafür angezeigt werden.

Speicherorte abrufen (GetLocations)

Gibt eine Liste der unterstützten geografischen Standorte zurück, die an den location Parameter einer Suche übergeben werden können. Verwenden Sie diese Einstellung, um die genaue Standortzeichenfolge für eine Stadt oder Region nachzuschlagen, bevor Sie eine Suche ausführen.

Kontoinformationen abrufen (GetAccount)

Gibt Informationen zu Ihrem SerpApi-Konto zurück, einschließlich Ihres aktuellen Plans, des monatlichen Suchkontingents, der verbleibenden Suchvorgänge und stündliche Nutzungsstatistiken.

Abrufen von Anmeldeinformationen

1. Melden Sie sich bei Ihrem SerpApi-Konto bei serpapi.com an.
2. Navigieren Sie zu serpapi.com/manage-api-key.
3. Kopieren Sie Ihren API-Schlüssel.
4. Fügen Sie beim Erstellen einer Verbindung in Power Apps oder Power Automate Ihren API-Schlüssel in das FELD "API-Schlüssel" ein.

Ihr API-Schlüssel wird sicher von Power Platform gespeichert und automatisch in jede Anforderung eingefügt. Sie müssen sie nach der Einrichtung der Verbindung nicht erneut bereitstellen.

Getting Started

Grundlegende Nutzung

Die GoogleSearch Aktion verwendet ein erforderliches Argument (die Suchabfrage) und einen optionalen Datensatz zusätzlicher Parameter:

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

So zeigen Sie die unformatierte JSON-Antwort in einem HTML-Textsteuerelement zum Debuggen an:

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

Übergeben optionaler Parameter

Optionale Parameter werden als Datensatz (das zweite Argument) übergeben. Fügen Sie nur die Parameter ein, die Sie festlegen möchten. Wenn Sie einen Schlüssel weglassen, wird nichts für diesen Parameter gesendet, sodass SerpApi seine eigene Standardeinstellung verwendet.

Im folgenden Beispiel sind die Eingabetypen und Namen Empfehlungen, nicht obligatorisch.

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

Steuerelementtypzuordnung:

Parametertyp	Empfohlenes Power Apps-Steuerelement	Wertreferenz
Text (Zeichenfolge)	Texteingabe	controlName.Text
Boolean	Umschalten oder Kontrollkästchen	controlName.Value
Enumeration (feste Optionen)	Dropdownliste	controlName.Selected.Value
Number	Texteingabe	controlName.Text

Zugreifen auf Antwortdaten

Die Antwort ist ein JSON-Objekt. Greifen Sie direkt von der Variablen auf Eigenschaften der obersten Ebene zu:

varJsonResponse.search_information.total_results

So binden Sie einen Katalog an die organischen Ergebnisse:

varJsonResponse.organic_results

So binden Sie einen Katalog an lokale Geschäftsergebnisse:

varJsonResponse.local_results.places

Die vollständige Liste der Antwortfelder finden Sie in der SerpApi Google Search-Dokumentation .

Nachschlagen einer gültigen Speicherortzeichenfolge

Wird verwendet GetLocations , um den genauen Speicherortnamen zu finden, an den übergeben werden GoogleSearchsoll. Der q Parameter filtert nach Orts- oder Regionsname und limit klammert die Anzahl der zurückgegebenen Ergebnisse.

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

So binden Sie die Ergebnisse an einen Katalog:

varLocations

Jedes Element in der Auflistung verfügt über name, , canonical_namecountry_code, target_type, , reachund gps Felder. Übergeben Sie den canonical_name Wert als location Parameter in einem nachfolgenden GoogleSearch Aufruf:

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

Überprüfen der Kontonutzung

Dient GetAccount zum Abrufen der aktuellen Plandetails und der Kontingentnutzung. Dies ist nützlich, um zu überprüfen, wie viele Suchvorgänge verbleiben, bevor Sie ihr monatliches Limit erreichen.

Set(varAccount, SerpApi.GetAccount())

Greifen Sie auf einzelne Felder außerhalb der Antwort zu:

varAccount.plan_searches_left
varAccount.this_month_usage
varAccount.account_rate_limit_per_hour

Die vollständige Liste der Antwortfelder finden Sie in der Dokumentation zur SerpApi-Konto-API .

Bekannte Probleme und Einschränkungen

• Variable Antwortstruktur: Die Felder, die in einer Google Search-Antwort vorhanden sind, sind von der Abfrage und der Rückgabe von Google abhängig. Nicht alle Felder werden in jeder Antwort angezeigt. Eine vollständige Beschreibung möglicher Antwortfelder finden Sie in der SerpApi Google Search-Dokumentation .
• Rate limits: Requests are subject to your SerpApi plan's monthly quota and hourly rate limit. Eine Überschreitung dieser Beiden führt zu einer 429 Fehlerantwort.
• Zwischengespeicherte Ergebnisse: Standardmäßig liefert SerpApi Ergebnisse aus dem Cache für doppelte Anforderungen, die für jeden Benutzer spezifisch sind (bis zu 1 Stunde alt). Verwenden Sie den no_cache Parameter, um ein neues Ergebnis zu erzwingen. Beachten Sie, dass zwischengespeicherte Suchvorgänge nicht auf Ihr monatliches Kontingent zählen.

Support

Um Hilfe zu diesem Connector oder Ihrem SerpApi-Konto zu haben, wenden Sie sich an das SerpApi-Supportteam:

• Email:contact@serpapi.com
• Live-Chat: Verfügbar 24/7 bei serpapi.com, wo Sie direkt mit einem Mitglied des SerpApi-Supportteams sprechen können.

Erstellen einer Verbindung

Der Connector unterstützt die folgenden Authentifizierungstypen:

Vorgabe	Parameter zum Erstellen einer Verbindung.	Alle Regionen	Nicht teilbar

Vorgabe

Anwendbar: Alle Regionen

Parameter zum Erstellen einer Verbindung.

Dies ist keine freigabefähige Verbindung. Wenn die Power-App für einen anderen Benutzer freigegeben wird, wird ein anderer Benutzer aufgefordert, eine neue Verbindung explizit zu erstellen.

Name	Typ	Description	Erforderlich
API-Schlüssel	securestring	Ihr SerpApi-API-Schlüssel. Suchen Sie es unter https://serpapi.com/manage-api-key	True

Aktionen

Google Search	Rufen Sie strukturierte Google Search-Ergebnisse für eine bestimmte Abfrage ab. Gibt organische Ergebnisse, Anzeigen, Wissensdiagramm, verwandte Fragen, Top Stories, lokale Ergebnisse und mehr zurück.
Kontoinformationen abrufen	Gibt Informationen zum authentifizierten SerpApi-Konto zurück, einschließlich Plandetails, verbleibenden Suchvorgängen und Nutzungsstatistiken.
Speicherorte abrufen	Gibt eine Liste der unterstützten geografischen Standorte zurück, die mit dem Standortparameter in einer Suche verwendet werden können. Nützlich für die Suche nach der genauen Standortzeichenfolge für eine Stadt oder Region.

Google Search

Kontoinformationen abrufen

Speicherorte abrufen

Definitionen

Location

KontoInfo