v1Recursos/SEO/postRegenerar o relatório de grade de classificação de um local

Regenerar o relatório de grade de classificação de um local

Dispara uma nova extração em segundo plano da grade de classificação de busca local para um local e/ou uma palavra-chave monitorada específica. Isso é disparar-e-esquecer: a chamada retorna imediatamente após o job ser enfileirado, e o novo relatório chega de forma assíncrona — consulte GET /api/v1/seo/keywords (ou GET /api/v1/seo/competitors, etc.) depois para vê-lo.

post/api/v1/seo/reports/generate

seo:write

Corpo da solicitação

locationIdstringopcional

Regenera a grade de cada palavra-chave ativa para este local. Opcional se keywordId for informado.

keywordIdstringopcional

Regenera a grade apenas para esta palavra-chave monitorada. Opcional se locationId for informado.

monthstringopcional

Gera a grade de classificação deste mês (YYYY-MM) em vez do mês atual.

clientIdstringopcional

O cliente do local (ou do local proprietário da palavra-chave).

Resposta

dataobjectopcional

generatingbooleanopcional

Sempre true — um job de geração em segundo plano foi enfileirado.

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.

404O recurso não foi encontrado, ou não pertence à sua agência.

429Muitas solicitações. Tente novamente após o número de segundos indicado no cabeçalho Retry-After.

post/api/v1/seo/reports/generate

Sua chave de API

Corpo da solicitação

{
  "data": {
    "generating": true
  }
}