Custom Search JSON API

Mit der Custom Search JSON API können Sie Websites und Anwendungen entwickeln, um Suchergebnisse aus der Programmable Search Engine programmatisch abzurufen und anzuzeigen. Mit dieser API können Sie RESTful-Anfragen verwenden, um Ergebnisse der Websuche oder der Bildersuche im JSON-Format abzurufen.

Datenformat

Die Custom Search JSON API kann Ergebnisse im JSON-Datenformat zurückgeben.

Die Custom Search JSON API verwendet die OpenSearch 1.1-Spezifikation.

Vorbereitung

Suchmaschinen-ID

Bevor Sie die Custom Search JSON API verwenden können, müssen Sie zuerst Ihre Programmable Search Engine erstellen und konfigurieren. Wenn Sie noch keine Programmable Search Engine erstellt haben, können Sie das im Steuerfeld der Programmable Search Engine tun.

In der Anleitung finden Sie weitere Informationen zu den verschiedenen Konfigurationsoptionen.

Nachdem Sie eine Programmable Search Engine erstellt haben, finden Sie in der Hilfe Informationen dazu, wie Sie Ihre Suchmaschinen-ID finden.

API-Schlüssel

Für die Custom Search JSON API ist ein API-Schlüssel erforderlich.

Preise

Die folgenden Preise gelten nur für Bestandskunden der Custom Search JSON API bis zur Einstellung des Dienstes am 1. Januar 2027. Diese API ist für Neukunden nicht verfügbar. Die Custom Search JSON API bietet 100 Suchanfragen pro Tag kostenlos. Wenn Sie mehr benötigen, können Sie sich in der API Console für die Abrechnung registrieren. Zusätzliche Anfragen kosten 5 $ pro 1.000 Anfragen, bis zu 10.000 Anfragen pro Tag.

Monitoring

Ein grundlegendes Monitoring für die Custom Search JSON API ist über das API-Dashboard der Cloud Platform Console verfügbar. Für ein erweitertes Monitoring ist die Operations-Suite von Google Cloud (früher Stackdriver) verfügbar.

Mit Google Cloud Operations können Sie benutzerdefinierte Dashboards erstellen, Benachrichtigungen einrichten und programmatisch auf Messwertdaten zugreifen. Wenn Sie in Google Cloud Operations auf Nutzungsdaten der Custom Search JSON API zugreifen möchten, wählen Sie im Query Builder „Ressourcentyp: Verbrauchte API“ aus und filtern Sie nach „service = 'customsearch.googleapis.com'“.

Unter API-Nutzung überwachen finden Sie eine Erläuterung der verschiedenen Monitoring- und Benachrichtigungsfunktionen, die im API-Dashboard und in der Google Cloud Operations-Suite verfügbar sind.