Synup
Criar chave
v1Recursos/SEO/postAdicionar palavras-chave monitoradas a um local

Adicionar palavras-chave monitoradas a um local

Começa a monitorar uma ou mais palavras-chave na grade de classificação de busca local de um local, configurando o tamanho e o raio da grade na primeira vez em que o local é configurado. As palavras-chave são desduplicadas sem diferenciar maiúsculas/minúsculas e limitadas a 25 por local. Dispara uma varredura de classificação em segundo plano para cada palavra-chave recém-adicionada — consulte GET /api/v1/seo/keywords depois para ver os resultados chegarem.

post/api/v1/seo/keywords
seo:write
Corpo da solicitação
locationIdstringobrigatório
O local para o qual monitorar palavras-chave.
clientIdstringopcional
O cliente do local.
keywordsarray of stringobrigatório
Palavras-chave a começar a monitorar, até 25 (desduplicadas sem diferenciar maiúsculas/minúsculas; a primeira grafia enviada prevalece).
gridSizeinteger (3 | 5 | 7)opcional
Tamanho da grade (3, 5 ou 7 pontos por lado). Aplicado apenas na primeira vez em que a grade deste local é configurada — chamadas posteriores que omitem isso, ou que visam um local já configurado, deixam o tamanho da grade armazenado inalterado.
distanceKmnumberopcional
Distância em quilômetros entre pontos adjacentes da grade. Mesma regra de aplicação apenas na primeira vez que gridSize; o padrão é 1,5 km quando o local ainda não tem uma grade configurada.
excludedarray of objectopcional
Pontos da grade a excluir da medição — ex.: um lago, o território de um concorrente. Os pontos ainda são coletados de qualquer forma; isso só controla se contam nas estatísticas.
rowintegeropcional
Índice de linha da grade, começando em 0.
colintegeropcional
Índice de coluna da grade, começando em 0.
Resposta
dataobjectopcional
keywordsarray of objectopcional
As palavras-chave que foram adicionadas ou reativadas por esta chamada.
idstringopcional
Identificador único da palavra-chave monitorada.
keywordstringopcional
O texto da palavra-chave como armazenado (usando a primeira grafia enviada).
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.
422Falta um parâmetro obrigatório na solicitação, ou ela é inválida de outra forma.
429Muitas solicitações. Tente novamente após o número de segundos indicado no cabeçalho Retry-After.
post/api/v1/seo/keywords
Sua chave de API
Corpo da solicitação*
{
  "data": {
    "keywords": [
      {
        "id": "cm_kw_abc123",
        "keyword": "dentist near me"
      }
    ]
  }
}

Guias que usam este endpoint