Zum Hauptinhalt springen
Google SERP (Search Engine Results Page) ist die Ergebnisseite, die Nutzer sehen, nachdem sie eine Suchanfrage in der Google-Suchmaschine eingegeben haben. Sie zeigt organische Suchergebnisse, Werbung, hervorgehobene Snippets, Knowledge Graphs sowie verschiedene Inhalte wie Bilder und Videos an und zielt darauf ab, Nutzern die relevantesten Informationen bereitzustellen. Dieser Artikel wird die Google SERP API detailliert vorstellen, die Ergebnisse bereitstellen kann, indem Anfragen in der Google-Suchmaschine eingegeben werden. Die Inhalte der Ergebnisse umfassen ebenfalls viele Typen, wie hervorgehobene Snippets, Knowledge Graphs sowie verschiedene Ergebnisse wie Bilder. Dieses Dokument wird die Integrationsanleitung für die Google SERP API vorstellen.

​
Antragsprozess

Um die Google SERP API zu verwenden, rufen Sie zunächst die Ace Data Cloud-Konsole auf, um Ihren API-Token zu erhalten und ihn als Reserve aufzubewahren. Wenn Sie noch nicht angemeldet oder registriert sind, werden Sie automatisch zur Anmeldeseite weitergeleitet und zur Registrierung und Anmeldung eingeladen. Nach Abschluss kehren Sie automatisch zu dieser Seite zurück. Ein API-Token kann alle Dienste der Plattform aufrufen, ohne dass für jeden Dienst ein separater Antrag erforderlich ist. Bei der ersten Beantragung wird ein kostenloses Guthaben vergeben, das kostenlos ausprobiert werden kann; wenn das Guthaben nicht ausreicht, kann in der Konsole ein allgemeines Guthaben aufgeladen werden.
📘 Vollständige Dokumentation: Google SERP API →

​
Grundlegende Verwendung

Durch Eingabe von Schlüsselwörtern und des Typs der Suchressource können Ergebnisse erhalten werden: Verwenden Sie query, um Schlüsselwörter zu übermitteln, und type, um Suchtypen wie Webseiten, Bilder und Nachrichten auszuwählen; diese Schnittstelle benötigt keinen Parameter model. Wenn Sie beispielsweise nach Informationen über „apple inc“ suchen, können wir anschließend die entsprechenden Inhalte in der Oberfläche ausfüllen, wie in der Abbildung gezeigt:

Hier sehen wir, dass wir die Request Headers festgelegt haben, einschließlich:
  • accept: Welches Format der Antwortergebnisse empfangen werden soll; hier wird application/json eingetragen, also das JSON-Format.
  • authorization: Der Schlüssel zum Aufrufen der API, der nach der Beantragung direkt über das Dropdown-Menü ausgewählt werden kann.
Zusätzlich wurden die Request Body-Einstellungen festgelegt, einschließlich:
  • type: Der Typ der Suchressource. Derzeit werden nur sechs Typen unterstützt, der Standardwert ist search.
  • query: Das Schlüsselwort für die Suche.
  • country: Das Land, in dem die Suchergebnisse angepasst werden sollen; der Standardwert sind die Vereinigten Staaten (US).
  • language: Die Sprache, in der die Suchergebnisse angepasst werden sollen; der Standardwert ist Englisch (en).
  • range: Der Zeitraum, in dem die Suchergebnisse angepasst werden sollen; standardmäßig gibt es keine Einschränkung.
  • number: Die Seitengröße der Paginierung für die angepassten Suchergebnisse; der Standardwert ist 10.
  • page: Die Seitenzahl der Paginierung für die angepassten Suchergebnisse; der Standardwert ist 1.
Nach der Auswahl können Sie feststellen, dass auf der rechten Seite auch der entsprechende Code generiert wurde, wie in der Abbildung gezeigt:

Klicken Sie auf die Schaltfläche „Try“, um einen Test durchzuführen. Wie in der obigen Abbildung gezeigt, erhalten wir hier die folgenden Ergebnisse:
Das zurückgegebene Ergebnis enthält mehrere Felder, die wie folgt beschrieben werden:
  • knowledge_graph, der Wissensgraph der Suchergebnisse.
  • organic, die detaillierten Informationen der Suchergebnisse.
  • people_also_ask, Fragen im Zusammenhang mit den Suchbegriffen.
  • related_searches, verwandte Suchanfragen zu den Suchbegriffen.
Wie zu sehen ist, gibt es in den hier zurückgegebenen Ergebnissen ein Feld organic, das hauptsächlich die Ergebnisse der Suchbegriffe enthält. Wenn Sie außerdem den entsprechenden Integrationscode generieren möchten, können Sie ihn direkt kopieren und generieren, zum Beispiel lautet der CURL-Code wie folgt:
Der Python-Integrationscode lautet wie folgt:

​
Benutzerdefinierter Suchtyp

Wenn Sie den Typ der Suchressourcen anpassen, können wir den Parameter type ändern. Er umfasst allgemeine Ressourcen search, Bildressourcen images, Nachrichtenressourcen news, Kartenressourcen maps, regionale Ressourcen places und Videoressourcen videos; dieser Artikel verwendet die Videoressource videos als Beispiel. Im Folgenden demonstrieren wir die konkreten Schritte. Setzen Sie zunächst den Parameter type auf videos und übergeben Sie den Parameter query wie gewohnt, wie in der Abbildung gezeigt:

Der entsprechende Code lautet wie folgt:
Es kann die folgende Antwort erhalten werden:
Das Rückgabeergebnis umfasst mehrere Felder, die wie folgt beschrieben werden:
  • news, Liste der Videoinformationen in den Suchergebnissen.
Es ist zu sehen, dass es in dem hier zurückgegebenen Ergebnis ein Feld videos gibt, das hauptsächlich die Ergebnisse des Suchbegriffs enthält.

​
Das Land anpassen, in dem sich die Suchressource befindet

Diese Schnittstelle unterstützt auch die Einschränkung des Landes, in dem sich die Suchergebnisse befinden. Wir können den Parameter country hinzufügen, um das Land einzuschränken. Der eingegebene Parameter ist die Abkürzung des Landes, beispielsweise cn (China), us (Vereinigte Staaten). Dieser Artikel verwendet China als folgendes Beispiel, die konkreten Informationen sind nachstehend aufgeführt:

Der Ausgabeeffekt lautet wie folgt:
Wie man sehen kann, handelt es sich bei den Ergebnissen um Suchergebnisse im Land China, deren konkrete Inhalte den oben genannten ähnlich sind.

​
Sprache der benutzerdefinierten Suchergebnisse

Wir können auch die Sprache der Suchergebnisse anpassen. Hier fügen wir zusätzlich das Feld language hinzu, dessen Inhalt zh-cn ist, wobei es für die Sprache Chinesisch (vereinfacht) steht. Gleichzeitig werden auch andere Sprachen unterstützt, aber es muss die Abkürzung der eingegebenen Sprache angegeben werden, wie zum Beispiel en (English), fr (French), zh-cn (Chinese (Simplified)) und andere Sprachen, wie in der Abbildung gezeigt:

Der entsprechende Code lautet wie folgt:
Das Ausführungsergebnis lautet wie folgt:
Es ist zu sehen, dass die hier angezeigten Ergebnisse alle in vereinfachtem Chinesisch sind, und der Inhalt der Ergebnisse dem oben genannten ähnlich ist.

​
Zeitbereich der Suchergebnisse anpassen

Hier kann auch der Zeitraum der Suchergebnisse angepasst werden, einschließlich fünf Arten, nämlich qdr:h (vergangene Stunde), qdr:d (vergangener Tag), qdr:w (vergangene Woche), qdr:m (vergangener Monat) und standardmäßig unbegrenzt. Wir können den entsprechenden Zeitraum über range übergeben. Wenn hier beispielsweise qdr:d eingestellt wird, bedeutet dies, dass die Ergebnisse des vergangenen Tages gesucht werden. Die Eingabe lautet also wie folgt:

Der entsprechende Code lautet wie folgt:
Das Ausführungsergebnis lautet wie folgt:
Wie zu sehen ist, haben wir erfolgreich die Suchergebnisse des vergangenen Tages erhalten, und der Inhalt der Ergebnisse ähnelt dem oben beschriebenen.

​
Benutzerdefinierte Paginierung der Suchergebnisse

Diese API unterstützt auch die benutzerdefinierte Paginierungsanzeige von Suchergebnissen. number und page stehen für die Seitengröße und Seitenzahl der Paginierung. In diesem Artikel wird die Paginierungsanzeige mit 20 Suchergebnissen pro Seite eingestellt. Die genauen Informationen sind in der Abbildung dargestellt:

Hinweis: Wenn die Ergebnisse pro Seite 10 überschreiten, werden die abgezogenen Punkte verdoppelt.
Der Code lautet wie folgt:
Das Ausführungsergebnis lautet wie folgt:
Man kann sehen, dass die Suchergebnisse hier paginiert angezeigt werden, wobei auf einer Seite 20 Ergebnisse angezeigt werden und der Inhalt der Ergebnisse dem oben genannten ähnlich ist.