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