Rank-Tracking-API: Live-Positionen in den Google-Top-10 nach Land und Gerät

Warum eine SERP API statt eines Rank-Tracking-SaaS

Ein Rank-Tracking-Dienst verkauft Ihnen seinen Zeitplan, seine Keyword-Limits und seine Berichte. Eine SERP API verkauft Ihnen das Rohmaterial: die Live-Top-10, oder bis zu den Top 100, für jedes Keyword; Zeitplan, Speicherung und Berichte bleiben in Ihrer Hand.

Das macht Serper.live zum Backend für einen Tracker, der Ihnen gehört: ein Agentur-Dashboard, ein Modul in Ihrem SEO-Produkt, ein nächtlicher Job, der Positionen in Ihre Datenbank schreibt. Keine Nutzerplätze, keine Keyword-Kontingente, keine Tarife pro Projekt; die Rechnung ist die Zahl der Suchen multipliziert mit dem Marktpreis.

Der Kompromiss ist klar: Sie schreiben Scheduler und Speicherung, und jede Prüfung ist eine echte Google-Suche, die ein paar Sekunden dauert. Dafür wurde jede gespeicherte Position zu einer bekannten Zeit, für ein bekanntes Land und Gerät abgerufen, nie aus einem Cache.

So erhalten Sie die Position eines Keywords

Eine Anfrage pro Keyword, Land und Gerät. Die Dokumentation enthält die vollständige Referenz; die Logik in Ihrem Code sind vier Schritte, und das Beispiel unten ist dieselbe Anfrage in curl, JavaScript und Python:

1. Senden Sie POST /v1/search mit query, country und device, optional language und limit. Eine Live-Suche antwortet meist in 2–3 Sekunden, die erste an einen Markt nach einer Pause dauert länger: lassen Sie dem Client ein Timeout von mindestens 100 Sekunden und führen Sie Prüfungen aus einer Warteschlange aus.
2. Lesen Sie organic[]. Jeder Eintrag hat position, title, url, domain und snippet, in der Reihenfolge, in der Google sie zeigt.
3. Finden Sie den Eintrag, dessen domain zur verfolgten Site passt, und speichern Sie seine position mit fetchedAt und requestId. Entscheiden Sie vorab, ob eine Subdomain für die Hauptdomain zählt, und ignorieren Sie ein führendes www..
4. Kein Treffer bedeutet außerhalb des angeforderten Bereichs für diese Prüfung, standardmäßig der Top 10. Speichern Sie auch das: ein Keyword, das aus den Top 10 fällt, ist genau das, wofür ein Tracker da ist.

curl -s -X POST https://api.serper.live/v1/search \
  -H "Authorization: Bearer sl_live_YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"query":"best coffee shops","country":"DE","device":"desktop"}' \
  | jq '.organic[] | select(.domain == "example.com") | .position'

const response = await fetch('https://api.serper.live/v1/search', {
    method: 'POST',
    headers: {
        Authorization: 'Bearer sl_live_YOUR_TOKEN',
        'Content-Type': 'application/json',
    },
    body: JSON.stringify({ query: 'best coffee shops', country: 'DE', device: 'desktop' }),
    signal: AbortSignal.timeout(100000),
});
const { organic } = await response.json();
const hit = organic.find(row => row.domain === 'example.com');

console.log(hit ? hit.position : 'outside the top 10');

import requests

response = requests.post(
    "https://api.serper.live/v1/search",
    headers={"Authorization": "Bearer sl_live_YOUR_TOKEN"},
    json={"query": "best coffee shops", "country": "DE", "device": "desktop"},
    timeout=100,
)
organic = response.json()["organic"]
position = next((row["position"] for row in organic if row["domain"] == "example.com"), None)
print(position or "outside the top 10")

Märkte und Geräte

Derzeit offene Märkte: Deutschland, Frankreich, Vereinigtes Königreich, Türkei, Ukraine und Vereinigte Staaten. Jeder Markt hat einen zweibuchstabigen Code, den Sie als country übergeben, eine Google-Standardsprache, die Sie mit language überschreiben können, und Desktop wie Mobil zum selben Preis.

Neue Märkte erscheinen in GET /v1/countries und auf der Preisseite, sobald sie starten; Ihre Integration ändert sich nicht.

Was es kostet

Eine Prüfung ist eine Anfrage: ab $0.01 pro Keyword, Land und Gerät, also $10.00 pro 1.000 Prüfungen. Es gibt kein Abo, und das Guthaben wird ab 5 $ in USDT oder USDC vorausbezahlt und verfällt nie.

Beispiel: 500 Keywords, einmal täglich auf einem Gerät geprüft, ergeben etwa 15.000 Anfragen im Monat. Multiplizieren Sie mit dem Preis Ihres Marktes, oder tippen Sie die Zahl in den Rechner auf der Preisseite. Desktop und Mobil verdoppeln die Zahl; zwei Prüfungen am Tag verdoppeln sie noch einmal.

Limits, die Sie kennen sollten

• Eine Live-Suche dauert meist 2–3 Sekunden, die erste für einen Markt nach einer Pause länger. Planen Sie für Durchsatz: führen Sie Prüfungen parallel aus einer Warteschlange aus, mit einem Client-Timeout von mindestens 100 Sekunden.
• Positionen gehen so tief, wie Sie fragen: limit 1–100, standardmäßig 10. Jeder angefangene Block von 10 kostet einen Marktpreis, eine Prüfung der Top 30 reserviert also drei Preise und behält nur die Blöcke, die Ergebnisse erhalten haben; eine Site außerhalb des angeforderten Bereichs wird als abwesend gemeldet, nicht als Position.
• Nichts wird zwischengespeichert. Zwei identische Anfragen sind zwei Live-Suchen und zwei Abbuchungen; behalten Sie die Ergebnisse auf Ihrer Seite.
• Ergebnisse gelten für das Land, Gerät und die Sprache, die Sie senden. Vergleichen Sie eine Position nur mit früheren Prüfungen, die mit denselben drei Werten gemacht wurden.
• Google variiert die Ergebnisse zwischen Prüfungen und über die Zeit. Eine Live-Prüfung ist eine Stichprobe; der Trend über Tage ist das Signal, das Sie berichten.

Beginnen Sie mit einem Keyword

Probieren Sie es aus, bevor Sie Code schreiben: der Playground führt drei Live-Suchen pro IP-Adresse und Tag ohne Konto aus, und sein Domain-Feld zeigt die Position sofort. Dann erstellen Sie ein Konto, laden ab 5 $ auf und senden die erste Anfrage aus dem Schnellstart.