v1Ressources/SEO/postAjouter des mots-clés suivis à un établissement

Ajouter des mots-clés suivis à un établissement

Démarre le suivi d'un ou plusieurs mots-clés sur la grille de classement de recherche locale d'un établissement, en configurant la taille de grille et le rayon lors de la première configuration de l'établissement. Les mots-clés sont dédupliqués sans distinction de casse et limités à 25 par établissement. Déclenche une analyse de classement en arrière-plan pour chaque mot-clé nouvellement ajouté — interrogez GET /api/v1/seo/keywords ensuite pour voir les résultats arriver.

post/api/v1/seo/keywords

seo:write

Corps de la requête

locationIdstringobligatoire

L'établissement pour lequel suivre des mots-clés.

clientIdstringfacultatif

Le client de l'établissement.

keywordsarray of stringobligatoire

Mots-clés à commencer à suivre, jusqu'à 25 (dédupliqués sans distinction de casse ; la première orthographe soumise l'emporte).

gridSizeinteger (3 | 5 | 7)facultatif

Taille de grille (3, 5 ou 7 points par côté). Appliquée uniquement la première fois que la grille de cet établissement est configurée — les appels suivants qui l'omettent, ou qui ciblent un établissement déjà configuré, laissent la taille de grille stockée inchangée.

distanceKmnumberfacultatif

Distance en kilomètres entre points de grille adjacents. Même règle de première configuration uniquement que gridSize ; par défaut 1,5 km quand l'établissement n'a encore aucune grille configurée.

excludedarray of objectfacultatif

Points de grille à exclure de la mesure — par ex. un lac, le territoire d'un concurrent. Les points sont quand même récupérés ; ceci contrôle seulement s'ils comptent dans les statistiques.

rowintegerfacultatif

Index de ligne de la grille, indexé à partir de 0.

colintegerfacultatif

Index de colonne de la grille, indexé à partir de 0.

Réponse

dataobjectfacultatif

keywordsarray of objectfacultatif

Les mots-clés qui ont été ajoutés ou réactivés par cet appel.

idstringfacultatif

Identifiant unique du mot-clé suivi.

keywordstringfacultatif

Le texte du mot-clé tel que stocké (en utilisant la première orthographe soumise).

Erreurs

400Il manque un paramètre requis à la requête, ou elle est invalide.

401Clé API manquante, invalide, expirée ou révoquée.

403La clé n'a pas la permission requise, ou n'est pas autorisée pour ce client/établissement.

422Il manque un paramètre requis à la requête, ou elle est invalide.

429Trop de requêtes. Réessayez après le nombre de secondes indiqué dans l'en-tête Retry-After.

post/api/v1/seo/keywords

Votre clé API

Corps de la requête*

{
  "data": {
    "keywords": [
      {
        "id": "cm_kw_abc123",
        "keyword": "dentist near me"
      }
    ]
  }
}