Docs
Search docs...⌘K

Keywords

API only
PUT/v3/management/project-keywords

Requests to this endpoint are free and do not consume any API units.

Query parameters

project_idintegerRequired

The unique identifier of the project. You can find it in the URL of your Rank Tracker project in Ahrefs: https://app.ahrefs.com/rank-tracker/overview/#project_id#

outputstring

The output format.

Allowed values:jsonphpxml

Request body

keywordsarray<object>Required

A list of keywords to add.

keywordstringrequired

The keyword to add.

tagsarray<string>

A list of tags to assign to a given keyword.

locationsarray<object>Required

A list of locations to assign to given keywords. You can use the 'Locations and languages' endpoint to get country codes, language codes and location IDs.

countrystringrequired

A two-letter country code (ISO 3166-1 alpha-2).

Allowed values:adaeafagaialamaoarasatauawazba…
location_idinteger

The location ID.

languagestring

The location code.

Responses

keywordsarray<object>
keywordstring

The keyword added to the project.

languagestring

The name of the language assigned to a given keyword.

language_codestring

The code of the language assigned to a given keyword.

locationstring

The name of the location assigned to a given keyword.

location_idinteger

The ID of the location assigned to a given keyword.

tagsarray<string>

A list of tags assigned to a given keyword.