Synup
Schlüssel erstellen
v1Ressourcen/SEO/getWettbewerber-Rangtrends im Zeitverlauf abrufen

Wettbewerber-Rangtrends im Zeitverlauf abrufen

Liefert den durchschnittlichen Rang je Monat für jeden Wettbewerber über die verfolgte Ranking-Historie dieses Standorts (bis zu den letzten 12 gemessenen Monaten), für das Rang-Trend-Diagramm. Enthält das eigene Unternehmen (isYou).

get/api/v1/seo/competitors/trends
seo:read
Query-Parameter
locationIdstringerforderlich
Der abzurufende Standort.
clientIdstringoptional
Der Kunde des Standorts.
Antwort
dataobjectoptional
monthsarray of stringoptional
Abgedeckte Monate, älteste zuerst (YYYY-MM).
competitorsarray of objectoptional
Eine Reihe je Wettbewerber (zuzüglich des eigenen Unternehmens), ausgerichtet auf months.
placeIdstringoptional
Eine Kennung für dieses Unternehmen (seine Place-ID oder ein abgeleiteter Schlüssel).
namestringoptional
Firmenname.
isYoubooleanoptional
Ob diese Reihe das eigene Unternehmen ist.
monthlyarray of numberoptional
Durchschnittlicher Rang für jeden Monat in months; null, wenn dieses Unternehmen in diesem Monat nicht beobachtet wurde.
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/competitors/trends
Ihr API-Schlüssel
locationId *
clientId
{
  "data": {
    "months": [
      "2026-01",
      "2026-02"
    ],
    "competitors": [
      {
        "placeId": "ChIJtXC2rwgF9YgRNh1YJHlA4vQ",
        "name": "Acme Dental — Downtown",
        "isYou": true,
        "monthly": [
          5.1,
          4.2
        ]
      }
    ]
  }
}

Anleitungen, die diese Ressource verwenden