Synup
Créer une clé
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"
      }
    ]
  }
}

Guides qui utilisent cet endpoint