Skip to main content
Google SERP (Search Engine Results Page) ist die Ergebnisseite, die Benutzer sehen, nachdem sie eine Abfrage in der Google-Suchmaschine eingegeben haben. Sie zeigt natürliche Suchergebnisse, Werbung, hervorgehobene Zusammenfassungen, Wissensgraphen sowie Bilder, Videos und verschiedene andere Inhalte an, um den Benutzern die relevantesten Informationen bereitzustellen. Dieser Artikel wird die Google SERP API im Detail vorstellen, die Ergebnisse liefert, wenn Abfragen in der Google-Suchmaschine eingegeben werden. Die Ergebnisse enthalten auch viele Arten von Inhalten, wie hervorgehobene Zusammenfassungen, Wissensgraphen und Bilder. Dieses Dokument wird die Integrationsanleitung der Google SERP API vorstellen.

​
Antragsprozess

Um die Google SERP API zu nutzen, müssen Sie zunächst im Ace Data Cloud Dashboard Ihr API-Token anfordern und zur späteren Verwendung aufbewahren. Wenn Sie noch nicht angemeldet oder registriert sind, werden Sie automatisch zur Anmeldeseite weitergeleitet, die Sie zur Registrierung und Anmeldung einlädt. Nach Abschluss werden Sie automatisch zur aktuellen Seite zurückgeleitet. Ein API-Token reicht aus, um auf alle Dienste der Plattform zuzugreifen, es ist nicht erforderlich, für jeden Dienst separat zu beantragen. Bei der ersten Anfrage erhalten Sie ein kostenloses Kontingent, um es kostenlos auszuprobieren; wenn das Kontingent erschöpft ist, können Sie im Dashboard Ihr allgemeines Guthaben aufladen.
📘 Vollständige Dokumentation: Google SERP API →

​
Grundlegende Nutzung

Zunächst sollten Sie die grundlegende Nutzung verstehen, bei der Sie den Typ der Suchressource und das Schlüsselwort eingeben, um die Suchergebnisse zu erhalten. Sie müssen lediglich das Feld query übergeben und das entsprechende Modell angeben. Zum Beispiel, um Informationen über „apple inc“ zu finden, können wir die entsprechenden Inhalte auf der Benutzeroberfläche eingeben, wie im Bild gezeigt:

Hier haben wir die Request-Header festgelegt, einschließlich:
  • accept: In welchem Format Sie die Antwort erhalten möchten, hier eingetragen als application/json, also im JSON-Format.
  • authorization: Der Schlüssel zur API, den Sie nach der Beantragung direkt auswählen können.
Zusätzlich haben wir den Request-Body festgelegt, einschließlich:
  • type: Der Typ der Suchressource, derzeit werden nur sechs Typen unterstützt, standardmäßig ist es search.
  • query: Das Suchschlüsselwort.
  • country: Das Land, in dem die Suchergebnisse angezeigt werden sollen, standardmäßig ist es die USA (US).
  • language: Die Sprache der Suchergebnisse, standardmäßig ist es Englisch (en).
  • range: Der Zeitrahmen der Suchergebnisse, standardmäßig ohne Einschränkungen.
  • number: Die Seitengröße der Suchergebnisse, standardmäßig 10.
  • page: Die Seitenzahl der Suchergebnisse, standardmäßig 1.
Nach der Auswahl können Sie feststellen, dass auf der rechten Seite auch der entsprechende Code generiert wurde, wie im Bild gezeigt:

Klicken Sie auf die Schaltfläche „Try“, um einen Test durchzuführen. Wie im obigen Bild gezeigt, haben wir die folgenden Ergebnisse erhalten:
返回结果一共有多个字段，介绍如下：
  • knowledge_graph，Suchergebnisse des Wissensgraphen.
  • organic，Suchergebnisse der detaillierten Informationen.
  • people_also_ask，Fragen, die mit dem Suchbegriff verbunden sind.
  • related_searches，Verwandte Suchanfragen zum Suchbegriff.
Kannst du sehen, dass es ein organic Feld gibt, das hauptsächlich die Ergebnisse des Suchbegriffs enthält. Wenn Sie auch den entsprechenden Code generieren möchten, können Sie ihn direkt kopieren, zum Beispiel ist der CURL-Code wie folgt:
Der Python-Code für die Integration sieht wie folgt aus:

​
Benutzerdefinierte Suchtypen

Wenn Sie den Typ der Suchressourcen anpassen möchten, können wir den Parameter type ändern, der die normalen Ressourcen search, Bildressourcen images, Nachrichtenressourcen news, Kartenressourcen maps, Ortsressourcen places, Videoressourcen videos umfasst. In diesem Artikel werden wir ein Beispiel mit Videoressourcen videos geben. Lassen Sie uns nun die spezifischen Operationen demonstrieren. Zuerst setzen Sie den Parameter type auf videos und übergeben den query Parameter normal, wie im Bild gezeigt:

Der entsprechende Code lautet wie folgt:
Es kann folgende Antwort erhalten werden:
Die Rückgabeergebnisse umfassen mehrere Felder, die wie folgt beschrieben werden:
  • news, die Liste der Videoinformationen in den Suchergebnissen.
Man kann sehen, dass es in den zurückgegebenen Ergebnissen ein videos-Feld gibt, das hauptsächlich die Ergebnisse der Suchanfrage enthält.

​
Anpassung des Suchressourcenlandes

Diese Schnittstelle unterstützt auch die Einschränkung der Suchergebnisse nach Land. Wir können den country-Parameter hinzufügen, um das Land zu begrenzen, wobei der eingegebene Parameter die Abkürzung des Landes ist, z. B. cn (China), us (Vereinigte Staaten). In diesem Artikel wird China als Beispiel verwendet, hier sind die spezifischen Informationen:

Die Ausgabe sieht wie folgt aus:
我们还可以 die Sprache der Suchergebnisse anpassen. Hier fügen wir das zusätzliche Feld language hinzu, dessen Inhalt zh-cn ist, was die Sprache für vereinfachtes Chinesisch bezeichnet. Es werden auch andere Sprachen unterstützt, aber die Abkürzung der Sprache muss eingegeben werden, wie z.B. en (Englisch), fr (Französisch), zh-cn (Chinesisch (vereinfacht)) usw., wie im Bild gezeigt:

Der entsprechende Code lautet wie folgt:
Das Ergebnis sieht wie folgt aus:
Man kann sehen, dass die hier angezeigten Ergebnisse alle in vereinfachtem Chinesisch sind und die Inhalte den oben genannten ähnlich sind.

​
Anpassung des Zeitrahmens der Suchergebnisse

本文 kann auch den Zeitrahmen der Suchergebnisse anpassen, einschließlich fünf Arten: qdr:h (letzte Stunde), qdr:d (letzter Tag), qdr:w (letzte Woche), qdr:m (letzter Monat), standardmäßig ohne Einschränkungen. Wir können den entsprechenden Zeitrahmen über range übergeben, zum Beispiel hier auf qdr:d gesetzt, was bedeutet, dass die Ergebnisse der letzten 24 Stunden gesucht werden, also wie folgt eingegeben:

Der entsprechende Code lautet:
Das Ergebnis sieht wie folgt aus:
Wir können sehen, dass wir erfolgreich die Suchergebnisse der letzten 24 Stunden erhalten haben, die Ergebnisse sind ähnlich wie oben beschrieben.

​
Benutzerdefinierte Suchergebnis-Paginierung

Diese API unterstützt auch die benutzerdefinierte Paginierung der Suchergebnisse, number und page geben die Seitengröße und die Seitenzahl an. In diesem Artikel wird eine Seite mit 20 Suchergebnissen zur Paginierung angezeigt, die spezifischen Informationen sind wie im Bild gezeigt:

Hinweis: Wenn die Ergebnisse pro Seite 10 überschreiten, verdoppeln sich die abgezogenen Punkte.
Der Code lautet wie folgt:
运行结果如下：
可以看到，这里它对搜索结果进行了分页展示，一页里面展示了 20 条结果，结果的内容与上文类似。