v1Ressourcen/SEO/getRanking-Übersicht eines Standorts abrufen
Ranking-Übersicht eines Standorts abrufen
Liefert verfolgte Keywords, den monatlichen Ranking-Trend, das Ranking-Raster und Kennzahlkarten für einen Standort. Übergeben Sie keywordId, um das Raster auf ein einzelnes Keyword zu beschränken, oder month (YYYY-MM), um es auf einen bestimmten Monat statt auf den zuletzt gemessenen Bericht jedes Keywords festzulegen.
get
seo:read/api/v1/seo/keywordsQuery-Parameter
locationIdstringerforderlich
Der abzurufende Standort.
clientIdstringoptional
Der Kunde des Standorts.
keywordIdstringoptional
Das Raster auf ein verfolgtes Keyword beschränken. Weglassen für das aggregierte Beste-Rang-je-Zelle-Raster über alle aktiven Keywords.
monthstringoptional
Das Raster und die Kennzahlen auf diesen Monat (YYYY-MM) festlegen, statt auf den zuletzt gemessenen Bericht jedes Keywords.
Antwort
dataobjectoptional
Es können weitere interne Felder vorhanden sein, die nicht Teil des stabilen Vertrags sind — verlassen Sie sich nur auf die hier dokumentierten Felder.
keywordsarray of objectoptional
Verfolgte Keywords für diesen Standort, jeweils mit aktuellem Rang und monatlichem Trend.
idstringoptional
Eindeutige Kennung des verfolgten Keywords.
keywordstringoptional
Der Keyword-Text.
avgRanknumberoptional
Der zuletzt gemessene durchschnittliche Rang des Keywords über das Raster (niedriger ist besser; null, falls nie gemessen oder nicht rankend).
monthlyarray of objectoptional
Der durchschnittliche Rang dieses Keywords für jeden Monat, für den ein Bericht vorliegt.
monthstringoptional
ranknumberoptional
monthsarray of objectoptional
Jeder Monat mit mindestens einem gemessenen Bericht, älteste zuerst, mit dem mittleren durchschnittlichen Rang über die Keywords für diesen Monat.
keystringoptional
Monat im Format YYYY-MM.
labelstringoptional
Für Menschen lesbare Beschriftung des Monats, z. B. „Aug 2026“.
avgRanknumberoptional
Mittlerer durchschnittlicher Rang über die verfolgten Keywords für diesen Monat, oder null.
gridarray of objectoptional
Das Ranking-Raster: ein Eintrag je gescraptem Punkt, zusammengeführt über die im Geltungsbereich liegenden Keyword(s)/den Monat.
idstringoptional
rowintegeroptional
Zeilenindex im Raster.
colintegeroptional
Spaltenindex im Raster.
latnumberoptional
Breitengrad dieses Rasterpunkts.
lngnumberoptional
Längengrad dieses Rasterpunkts.
ranknumberoptional
An diesem Punkt gefundener Rang (niedriger ist besser); null, falls nicht gemessen, Werte über 20 bedeuten „20+“.
excludedbooleanoptional
Ob dieser Punkt von den Kennzahlberechnungen des Standorts ausgeschlossen ist.
waterbooleanoptional
Ob dieser Punkt in Wasser (Meer, See, breiter Fluss) liegt und nur gezählt wird, wenn der Standort sich für die Einbeziehung von Wasserpunkten entschieden hat.
statsobjectoptional
Zusammengefasste Rangkennzahlen über das aktive Raster.
top3Pctnumberoptional
Prozentsatz der Rasterpunkte mit Rang in den Top 3, oder null.
top10Pctnumberoptional
Prozentsatz der Rasterpunkte mit Rang in den Top 10, oder null.
avgRanknumberoptional
Durchschnittlicher Rang über das Raster, oder null.
statCardsobjectoptional
Hervorhebungskarten, die das beste/schlechteste Keyword des Standorts und die größte Monat-über-Monat-Veränderung zusammenfassen.
bestobjectoptional
Das Keyword mit dem besten (niedrigsten) aktuellen durchschnittlichen Rang, oder null, falls noch keines rankt.
keywordstringoptional
avgRanknumberoptional
worstobjectoptional
Das Keyword mit dem schlechtesten aktuellen durchschnittlichen Rang, oder null.
keywordstringoptional
avgRanknumberoptional
gainerobjectoptional
Das Keyword, dessen Rang sich von seinem ersten bis zu seinem letzten Monat am stärksten verbessert hat, oder null.
keywordstringoptional
fromnumberoptional
tonumberoptional
dropperobjectoptional
Das Keyword, dessen Rang sich von seinem ersten bis zu seinem letzten Monat am stärksten verschlechtert hat, oder null.
keywordstringoptional
fromnumberoptional
tonumberoptional
notRankingCountnumberoptional
Rasterpunkte, die erfolgreich gemessen wurden, aber außerhalb der Top 20 ranken, oder null.
noDataCountnumberoptional
Rasterpunkte, die überhaupt nicht gemessen werden konnten (der Scrape ist fehlgeschlagen), unterschieden von „nicht rankend“, oder null.
centerobjectoptional
Der Kartenmittelpunkt für das Raster dieses Standorts (sein Unternehmensstandort), oder null, falls noch nicht konfiguriert.
latnumberoptional
lngnumberoptional
includeWaterPointsbooleanoptional
Ob sich dieser Standort für die Zählung von Rasterpunkten in Wasser entschieden hat.
Fehler
400Der Anfrage fehlt ein erforderlicher Parameter, oder sie ist anderweitig fehlerhaft.
401API-Schlüssel fehlt, ist ungültig, abgelaufen oder widerrufen.
403Dem Schlüssel fehlt die erforderliche Berechtigung, oder er ist für diesen Kunden/Standort nicht autorisiert.
429Zu viele Anfragen. Versuchen Sie es nach der im Retry-After-Header angegebenen Anzahl Sekunden erneut.
get/api/v1/seo/keywords
Ihr API-Schlüssel
locationId *
clientId
keywordId
month
{
"data": {
"keywords": [
{
"id": "cm_kw_abc123",
"keyword": "dentist near me",
"avgRank": 4.2,
"monthly": [
{
"month": "2026-01",
"rank": 5.1
},
{
"month": "2026-02",
"rank": 4.2
}
]
}
],
"months": [
{
"key": "2026-01",
"label": "Jan 2026",
"avgRank": 5.1
},
{
"key": "2026-02",
"label": "Feb 2026",
"avgRank": 4.2
}
],
"grid": [
{
"id": "cm_pt_1",
"row": 0,
"col": 0,
"lat": 30.2682,
"lng": -97.7441,
"rank": 3,
"excluded": false,
"water": false
}
],
"stats": {
"top3Pct": 44,
"top10Pct": 78,
"avgRank": 4.2
},
"statCards": {
"best": {
"keyword": "dentist near me",
"avgRank": 4.2
},
"worst": {
"keyword": "emergency dentist austin",
"avgRank": 9.6
},
"gainer": {
"keyword": "dentist near me",
"from": 5.1,
"to": 4.2
},
"dropper": {
"keyword": "family dentist",
"from": 3.8,
"to": 5.2
},
"notRankingCount": 1,
"noDataCount": 0
},
"center": {
"lat": 30.2672,
"lng": -97.7431
},
"includeWaterPoints": false
}
}