Wie man eine SERP API verwendet: Anleitung zur Integration der Google SERP API und zur API-Schlüssel-Einrichtung

Eine SERP API führt eine Suchmaschinenabfrage für Sie aus und liefert die Ergebnisseite als strukturiertes JSON zurück: organische Ergebnisse mit ihren Positionen, Anzeigen, Featured Snippets, lokale Ergebnisse und mehr. Statt Scraper für Google zu bauen und am Laufen zu halten, senden Sie eine Anfrage und lesen die Felder, die Sie benötigen.

Diese Anleitung führt Schritt für Schritt durch die Einrichtung von Grund auf: einen API-Key besorgen und speichern, die erste Suche durchführen, Ergebnisse für den richtigen Standort und das richtige Gerät erhalten, Fehler behandeln und Ergebnisse in eine Ranking-Prüfung verwandeln. Als Beispiel dient die SERP API von Shifter; die meisten SERP APIs funktionieren nach demselben Prinzip.

Schritt 1: Ihren API-Key besorgen

Jede Anfrage trägt einen API-Key. Öffnen Sie im Panel von Shifter SERP API, dann API Keys, und kopieren Sie einen aktiven Key.

Behandeln Sie den Key wie ein Passwort:

• Halten Sie ihn aus Code und Repositories heraus. Speichern Sie ihn in einer Umgebungsvariable oder einem Secrets-Manager.
• Verwenden Sie getrennte Keys für Entwicklung und Produktion, wo immer möglich, damit ein durchgesickerter Test-Key die Produktion nicht beeinträchtigen kann.
• Rotieren Sie einen Key, wenn er offengelegt worden sein könnte, und aktualisieren Sie ihn überall, wo er verwendet wird.

export SHIFTER_SERP_KEY="your-key-here"

Schritt 2: die erste Suche ausführen

Die API ist ein einzelner Endpunkt, https://serp.shifter.io/v1. Wählen Sie die Suchmaschine mit engine und übergeben Sie die Abfrage als q:

curl "https://serp.shifter.io/v1?engine=google&api_key=$SHIFTER_SERP_KEY&q=residential+proxies"

Die Antwort ist JSON. Bei einer Google-Suche enthält organic_results die gewöhnlichen Ergebnisse, jeweils mit position, title, link, displayed_link und snippet. Andere Abschnitte, etwa Anzeigen und lokale Ergebnisse, erscheinen, wenn die Ergebnisseite sie enthält.

Derselbe Endpunkt deckt weitere Suchmaschinen und Google-Oberflächen ab: Ändern Sie engine auf bing oder yandex für diese Suchmaschinen, oder auf google_maps, google_news oder google_shopping für andere Google-Ergebnisse. Der Rest dieser Anleitung gilt für alle davon; nur die Felder in der Antwort ändern sich.

Schritt 3: Ergebnisse für den richtigen Ort und das richtige Gerät erhalten

Suchergebnisse unterscheiden sich je nach Standort, Sprache und Gerät, oft erheblich. Eine Ranking-Prüfung, die nicht alle davon festlegt, misst jedes Mal eine andere Ergebnisseite.

Parameter	Was er festlegt	Beispiel
location	Von wo aus die Suche erfolgt	Austin,Texas,United States
gl	Das Land der Ergebnisse	us
hl	Die Sprache der Oberfläche	en
device	Desktop-, Mobil- oder Tablet-Ergebnisse	mobile

Schreiben Sie den Standort vollständig aus (Stadt, Region, Land), da kurze Namen wie „Springfield“ mehrdeutig sind. Unsere Anleitung zu geo-targeted SERP APIs für lokales SEO erklärt, warum Standortgenauigkeit so wichtig ist.

Schritt 4: Fehler behandeln

Anfragen können aus Gründen fehlschlagen, die vorübergehend sind, und aus Gründen, die es nicht sind:

• Wiederholen Sie Rate-Limits und temporäre Serverfehler, mit einer Pause, die jedes Mal wächst.
• Stoppen und beheben Sie Authentifizierungs- und Fehler durch fehlerhafte Anfragen; ein erneuter Versuch wiederholt nur den Fehlschlag.
• Legen Sie ein Timeout für jede Anfrage fest, damit eine langsame Suche nicht einen ganzen Durchlauf aufhält.

Alles zusammenfügen

Der folgende Helfer liest den Key aus der Umgebung, sendet immer Standort, Sprache und Gerät, wiederholt die Fehler, bei denen sich das lohnt, und enthält eine Funktion, die findet, wo eine Domain in den organischen Ergebnissen rangiert:

import os
import time
from urllib.parse import urlparse

import requests

API = "https://serp.shifter.io/v1"
RETRY = {408, 429, 500, 502, 503}


def google_search(query, location, gl="us", hl="en", device="desktop", session=None, attempts=3):
    """One Google search as seen from `location`, returned as parsed JSON."""
    session = session or requests.Session()
    params = {"engine": "google", "api_key": os.environ["SHIFTER_SERP_KEY"], "q": query,
              "location": location, "gl": gl, "hl": hl, "device": device}
    for attempt in range(1, attempts + 1):
        response = session.get(API, params=params, timeout=60)
        if response.status_code == 200:
            return response.json()
        if response.status_code not in RETRY or attempt == attempts:
            raise RuntimeError(f"{query!r}: HTTP {response.status_code} {response.text[:200]}")
        time.sleep(2 * attempt)


def rank_of(serp, domain):
    """Position of the first organic result on `domain`, or None if it is not there."""
    for result in serp.get("organic_results", []):
        host = urlparse(result["link"]).netloc.lower()
        if host == domain or host.endswith("." + domain):
            return result["position"]
    return None

Prüfen, wo eine Seite für zwei Keywords rankt, wie auf Mobilgeräten in Austin gesehen:

from serp import google_search, rank_of

keywords = ["emergency plumber", "water heater repair"]
for keyword in keywords:
    serp = google_search(keyword, location="Austin,Texas,United States", device="mobile")
    print(keyword, rank_of(serp, "example-plumbing.com"))

Wir haben die Anfrageparameter, Wiederholungsversuche, Fehlerbehandlung und Ranking-Abfrage des Helfers gegen simulierte Antworten getestet.

Schritt 5: in Ranking-Tracking verwandeln

Eine Suche ist eine Momentaufnahme. Tracking bedeutet, dieselben Suchen nach einem Zeitplan auszuführen und die Ergebnisse zu speichern:

1. Legen Sie die Keyword-Liste fest sowie Standort, Sprache und Gerät für jedes Keyword.
2. Führen Sie nach einem Zeitplan aus, täglich oder wöchentlich, je nachdem, wie stark sich Rankings in Ihrem Markt bewegen.
3. Speichern Sie jede vollständige Antwort mit ihrem Zeitpunkt und ihren Einstellungen, nicht nur die Position, damit Sie später nachvollziehen können, was sich geändert hat.
4. Alarmieren Sie bei Änderungen, die wichtig sind: ein Abfall aus den Top drei, ein Konkurrent, der über Ihnen erscheint, ein verlorenes Featured Snippet.

Unsere Anleitung zur Automatisierung der täglichen Überwachung von Keyword-Positionen behandelt Zeitplanung und Speicherung ausführlicher. Wenn Rank-Tracking ein zentraler Bestandteil Ihrer Arbeit ist, behandelt unsere Seite SEO-Monitoring die umfassendere Einrichtung.

Häufige Einrichtungsfehler

• Kein Standort festgelegt. Die Ergebnisse stammen dann von einem Standardstandort, der wahrscheinlich nicht Ihr Markt ist.
• Desktop und Mobil mischen zwischen Durchläufen, wodurch Rankings ohne echten Grund springen.
• Abgleich per exakter URL statt Domain, sodass eine ranking Seite, deren Pfad sich geändert hat, wie ein verlorenes Ranking aussieht.
• Nur Positionen speichern. Ohne die vollständige Antwort können Sie nicht erkennen, warum sich eine Position geändert hat.
• Den Key fest codieren, was früher oder später in einem Repository landet.

FAQ

Was ist eine SERP API?

Ein Dienst, der Suchmaschinenabfragen für Sie ausführt und die Ergebnisseite als strukturierte Daten zurückgibt, etwa organische Ergebnisse mit Positionen, Anzeigen, Featured Snippets und lokale Ergebnisse, sodass Sie Suchseiten nicht selbst scrapen und parsen müssen.

Wie bekomme ich einen SERP API-Key?

Melden Sie sich bei einem SERP API-Anbieter an und erstellen Sie einen Key in dessen Dashboard. Im Panel von Shifter befinden sich die Keys unter SERP API, dann API Keys. Speichern Sie den Key in einer Umgebungsvariable statt in Ihrem Code.

Warum unterscheiden sich meine SERP API-Ergebnisse von dem, was ich bei Google sehe?

Meist weil sich Standort, Sprache, Gerät oder Personalisierung unterscheiden. Ihre eigenen Suchen sind personalisiert und stammen von Ihrem Standort; legen Sie Standort, Sprache und Gerät der API explizit so fest, dass sie dem Markt entsprechen, den Sie messen möchten.

Wie oft sollte ich Rankings prüfen?

Täglich bei umkämpften Keywords und schnelllebigen Märkten, wöchentlich bei den meisten anderen. Halten Sie die Einstellungen zwischen den Durchläufen identisch, damit Änderungen die Ergebnisse widerspiegeln, nicht die Messung.

Fazit

Die Einrichtung einer SERP API umfasst ein paar Schritte: den Key sicher speichern, die Abfrage mit festgelegter Suchmaschine, Standort, Sprache und Gerät senden, nur die Fehler wiederholen, die vorübergehend sein können, und die Positionen aus den strukturierten Ergebnissen auslesen. Führen Sie dieselben Suchen nach einem Zeitplan aus, bewahren Sie die vollständigen Antworten auf, und Sie haben einen Ranking-Tracker, der jedes Mal dieselbe Ergebnisseite misst.