Synupv1
Criar chave
v1Recursos/SEO/getObter negócios classificados em um ponto da grade

Obter negócios classificados em um ponto da grade

Retorna os resultados de busca local capturados em uma única célula da grade para uma palavra-chave, em ordem de classificação.

get/api/v1/seo/grid-point
seo:read
Parâmetros de consulta
locationIdstringobrigatório
O local a ser consultado.
keywordIdstringobrigatório
A palavra-chave monitorada a que pertence a grade deste ponto.
rowintegerobrigatório
Índice da linha da grade do ponto.
colintegerobrigatório
Índice da coluna da grade do ponto.
clientIdstringopcional
O cliente do local.
monthstringopcional
Fixa o resultado neste mês (YYYY-MM) em vez do relatório mais recente medido da palavra-chave.
Resposta
dataobjectopcional
countnumberopcional
Número de negócios retornados.
businessesarray of objectopcional
Negócios classificados neste ponto da grade, em ordem de classificação.
idstringopcional
Um identificador para este negócio (seu place ID, nome, ou posição na lista).
ranknumberopcional
A classificação deste negócio neste ponto da grade (1 = primeiro).
namestringopcional
Nome do negócio.
photoUrlstringopcional
URL da foto, ou null (não retornado pela fonte de dados de busca local).
ratingnumberopcional
Classificação em estrelas, ou null.
reviewCountnumberopcional
Número de avaliações, ou null.
categorystringopcional
Categoria do negócio, ou null.
addressstringopcional
Endereço, ou null.
websitestringopcional
Site do negócio, ou null (não retornado pela fonte de dados de busca local).
isYoubooleanopcional
Se esta linha é o seu próprio negócio.
Erros
400Falta um parâmetro obrigatório na solicitação, ou ela é inválida de outra forma.
401Chave de API ausente, inválida, expirada ou revogada.
403A chave não tem a permissão exigida, ou não está autorizada para este cliente/local.
429Muitas solicitações. Tente novamente após o número de segundos indicado no cabeçalho Retry-After.
get/api/v1/seo/grid-point
Sua chave de 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
      }
    ]
  }
}