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
        ]
      }
    ]
  }
}