Synupv1
Créer une clé
v1Ressources/SEO/getObtenir les entreprises classées à un point de grille

Obtenir les entreprises classées à un point de grille

Renvoie les résultats de recherche locale capturés à une seule cellule de grille pour un mot-clé, dans l'ordre de classement.

get/api/v1/seo/grid-point
seo:read
Paramètres de requête
locationIdstringobligatoire
L'établissement à consulter.
keywordIdstringobligatoire
Le mot-clé suivi dont ce point fait partie de la grille.
rowintegerobligatoire
Index de ligne de la grille pour ce point.
colintegerobligatoire
Index de colonne de la grille pour ce point.
clientIdstringfacultatif
Le client de l'établissement.
monthstringfacultatif
Fige le résultat sur ce mois (YYYY-MM) au lieu du dernier rapport mesuré du mot-clé.
Réponse
dataobjectfacultatif
countnumberfacultatif
Nombre d'entreprises renvoyées.
businessesarray of objectfacultatif
Entreprises classées à ce point de grille, dans l'ordre de classement.
idstringfacultatif
Un identifiant pour cette entreprise (son place ID, son nom, ou sa position dans la liste).
ranknumberfacultatif
Le classement de cette entreprise à ce point de grille (1 = premier).
namestringfacultatif
Nom de l'entreprise.
photoUrlstringfacultatif
URL de la photo, ou null (non renvoyée par la source de données de recherche locale).
ratingnumberfacultatif
Note en étoiles, ou null.
reviewCountnumberfacultatif
Nombre d'avis, ou null.
categorystringfacultatif
Catégorie d'activité, ou null.
addressstringfacultatif
Adresse postale, ou null.
websitestringfacultatif
Site web de l'entreprise, ou null (non renvoyé par la source de données de recherche locale).
isYoubooleanfacultatif
Si cette ligne est votre propre entreprise.
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.
429Trop de requêtes. Réessayez après le nombre de secondes indiqué dans l'en-tête Retry-After.
get/api/v1/seo/grid-point
Votre clé API
locationId *
keywordId *
row *
col *
clientId
month
{
  "data": {
    "count": 1,
    "businesses": [
      {
        "id": "cm_biz_1",
        "rank": 3,
        "name": "Acme Dental — Downtown",
        "photoUrl": null,
        "rating": 4.6,
        "reviewCount": 210,
        "category": "Dentist",
        "address": "123 Main St, Austin, TX 78701",
        "website": null,
        "isYou": true
      }
    ]
  }
}