Synup
Schlüssel erstellen
v1Ressourcen/SEO/postVerfolgte Keywords zu einem Standort hinzufügen

Verfolgte Keywords zu einem Standort hinzufügen

Beginnt die Verfolgung eines oder mehrerer Keywords auf dem lokalen Ranking-Raster eines Standorts und konfiguriert beim ersten Einrichten des Standorts die Rastergröße und den Radius. Keywords werden ohne Beachtung der Groß-/Kleinschreibung dedupliziert und sind auf 25 pro Standort begrenzt. Löst für jedes neu hinzugefügte Keyword einen Hintergrund-Ranking-Scan aus — fragen Sie danach GET /api/v1/seo/keywords per Polling ab, um die Ergebnisse eintreffen zu sehen.

post/api/v1/seo/keywords
seo:write
Anfragetext
locationIdstringerforderlich
Der Standort, für den Keywords verfolgt werden sollen.
clientIdstringoptional
Der Kunde des Standorts.
keywordsarray of stringerforderlich
Zu verfolgende Keywords, bis zu 25 (ohne Beachtung der Groß-/Kleinschreibung dedupliziert; die erste eingereichte Schreibweise setzt sich durch).
gridSizeinteger (3 | 5 | 7)optional
Rastergröße (3, 5 oder 7 Punkte je Seite). Wird nur beim ersten Konfigurieren des Rasters dieses Standorts angewendet — spätere Aufrufe, die dies weglassen oder einen bereits konfigurierten Standort ansprechen, lassen die gespeicherte Rastergröße unverändert.
distanceKmnumberoptional
Abstand in Kilometern zwischen benachbarten Rasterpunkten. Gilt nur beim ersten Mal, wie gridSize; Standardwert 1,5 km, wenn für den Standort noch kein Raster konfiguriert ist.
excludedarray of objectoptional
Rasterpunkte, die von der Messung ausgeschlossen werden sollen — z. B. ein See, das Gebiet eines Wettbewerbers. Punkte werden trotzdem abgefragt; dies steuert nur, ob sie in die Statistik einfließen.
rowintegeroptional
Rasterzeilenindex, nullbasiert.
colintegeroptional
Rasterspaltenindex, nullbasiert.
Antwort
dataobjectoptional
keywordsarray of objectoptional
Die Keywords, die durch diesen Aufruf hinzugefügt oder reaktiviert wurden.
idstringoptional
Eindeutige Kennung des verfolgten Keywords.
keywordstringoptional
Der gespeicherte Keyword-Text (in der ersten eingereichten Schreibweise).
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.
422Der Anfrage fehlt ein erforderlicher Parameter, oder sie ist anderweitig fehlerhaft.
429Zu viele Anfragen. Versuchen Sie es nach der im Retry-After-Header angegebenen Anzahl Sekunden erneut.
post/api/v1/seo/keywords
Ihr API-Schlüssel
Anfragetext*
{
  "data": {
    "keywords": [
      {
        "id": "cm_kw_abc123",
        "keyword": "dentist near me"
      }
    ]
  }
}

Anleitungen, die diesen Endpunkt verwenden