Synup
Schlüssel erstellen
v1Ressourcen/Reviews/postWettbewerber hinzufügen

Wettbewerber hinzufügen

Beginnt, einen Wettbewerber anhand des Namens zu verfolgen — für einen einzelnen Standort (locationId und clientId übergeben) oder kundenweit als Roll-up-Wettbewerber, der für jeden Standort dieses Kunden angezeigt wird (nur clientId übergeben).

post/api/v1/reviews/competitors
reviews:write
Anfragetext
locationIdstringoptional
Der Standort, für den dieser Wettbewerber verfolgt werden soll. Zusammen mit alleiniger clientId weglassen, um stattdessen einen kundenweiten Roll-up-Wettbewerber hinzuzufügen.
clientIdstringoptional
Der Kunde des Standorts, zusammen mit locationId erforderlich; oder, allein, der Kunde, für den ein Roll-up-Wettbewerber hinzugefügt werden soll.
namestringerforderlich
Der Firmenname des Wettbewerbers.
Antwort
dataobjectoptional
competitorobjectoptional
Profilzeile eines Wettbewerbers (ID, Name, Quelle, angeheftet usw.).
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.
post/api/v1/reviews/competitors
Ihr API-Schlüssel
Anfragetext*
{
  "data": {
    "competitor": {
      "id": "cm_comp_1",
      "kind": "competitor",
      "source": "manual",
      "name": "Smile Bright Dental",
      "placeId": null,
      "address": null,
      "lastUpdated": null,
      "avgRating": null,
      "reviewCount": null
    }
  }
}

Anleitungen, die diesen Endpunkt verwenden