Palavras-chave

Somente API

PUT/v3/management/project-keywords

As solicitações para este endpoint são gratuitas e não consomem unidades da API.

Parâmetros de consulta

project_idintegerObrigatório

O identificador exclusivo do projeto. Você pode encontrá-lo na URL do seu projeto do Rank Tracker no Ahrefs: https://app.ahrefs.com/rank-tracker/overview/#project_id#

outputstring

O formato de saída.

Valores permitidos:jsoncsvxmlphp

Corpo da solicitação

locationsarray<object>Required

Uma lista de localizações para atribuir às palavras-chave informadas. Você pode usar o endpoint 'Localizações e idiomas' para obter códigos de país, códigos de idioma e IDs de localização.

countrystringrequired

O código do país.

languagestring

O código de idioma.

location_idinteger

O ID da localização.

keywordsarray<object>Required

Uma lista de palavras-chave para adicionar.

keywordstringrequired

A palavra-chave a ser adicionada.

tagsarray<string>

Uma lista de tags para atribuir a uma determinada palavra-chave.

Respostas

keywordsarray<object>

keywordstring

A palavra-chave adicionada ao Projeto.

language_codestring

O código do idioma atribuído a uma determinada palavra-chave.

languagestring

O nome do idioma atribuído a uma determinada palavra-chave.

location_idinteger

O ID da localização atribuída a uma determinada palavra-chave.

locationstring

O nome da localização atribuída a uma determinada palavra-chave.

tagsarray<string>

Uma lista de tags atribuídas a uma determinada palavra-chave.

curl "https://api.ahrefs.com/v3/management/project-keywords" \ -X PUT \ -H "Authorization: Bearer $AHREFS_API_KEY" \ -H "Accept: application/json" \ -H "Content-Type: application/json" \ --data-raw '{ "locations": [ { "country": "string", "language": "string", "location_id": 0 } ], "keywords": [ { "keyword": "string", "tags": ["string"] } ] }'

{ "keywords": [ { "keyword": "string", "language_code": "string", "language": "string", "location_id": 0, "location": "string", "tags": ["string"] } ] }