v1Ressourcen/Reviews/getVerfolgte Wettbewerber auflisten

Verfolgte Wettbewerber auflisten

Die für einen Standort verfolgten Wettbewerber, oder — mit clientId ohne locationId — die agenturweite Roll-up-Menge, die für jeden Standort dieses Kunden angezeigt wird.

get/api/v1/reviews/competitors
reviews:read
Query-Parameter
locationIdstringoptional
Der abzufragende Standort. Weglassen, um stattdessen die kundenweite Roll-up-Menge aufzulisten — dabei clientId übergeben.
clientIdstringoptional
Der Kunde des Standorts. Zusammen mit locationId erforderlich; allein listet es die kundenweite Roll-up-Menge auf.
Antwort
dataobjectoptional
competitorsarray of objectoptional
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.
404Die Ressource wurde nicht gefunden oder gehört nicht zu Ihrer Agentur.
429Zu viele Anfragen. Versuchen Sie es nach der im Retry-After-Header angegebenen Anzahl Sekunden erneut.
get/api/v1/reviews/competitors
Ihr API-Schlüssel
locationId
clientId
{
  "data": {
    "competitors": [
      {
        "id": "cm_comp_1",
        "kind": "competitor",
        "source": "manual",
        "name": "Smile Bright Dental",
        "placeId": "ChIJtXC2rwgF9YgRNh1YJHlA4vQ",
        "address": "45 Congress Ave, Austin, TX",
        "lastUpdated": "2026-02-01T06:00:00.000Z",
        "avgRating": 4.6,
        "reviewCount": 340
      }
    ]
  }
}

Anleitungen, die diese Ressource verwenden