关键词

仅限 API

PUT/v3/management/project-keywords

对该端点的请求免费，不会消耗任何 API 单位。

查询参数

project_idinteger必填

项目的唯一标识符。你可以在 Ahrefs 的 Rank Tracker 项目 URL 中找到：https://app.ahrefs.com/rank-tracker/overview/#project_id#

outputstring

输出格式。

允许的值:jsoncsvxmlphp

请求正文

locationsarray<object>Required

要分配给指定关键词的位置列表。你可以使用“Locations and languages”端点获取国家代码、语言代码和位置 ID。

countrystringrequired

国家代码。

languagestring

语言代码。

location_idinteger

地区 ID。

keywordsarray<object>Required

要添加的关键词列表。

keywordstringrequired

要添加的关键词。

tagsarray<string>

要分配给某个关键词的标签列表。

响应

keywordsarray<object>

keywordstring

添加到项目的关键词。

language_codestring

分配给某个关键词的语言代码。

languagestring

分配给某个关键词的语言名称。

location_idinteger

分配给某个关键词的地区 ID。

locationstring

分配给某个关键词的地区名称。

tagsarray<string>

分配给某个关键词的标签列表。

参数

project_id必填

output

请求正文

{
  "locations": [
    {
      "country": "string",
      "language": "string",
      "location_id": 0
    }
  ],
  "keywords": [
    {
      "keyword": "string",
      "tags": ["string"]
    }
  ]
}

API密钥

请求

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"]
    }
  ]
}'

import requests

url = "https://api.ahrefs.com/v3/management/project-keywords"
headers = {
    "Authorization": "Bearer $AHREFS_API_KEY",
    "Accept": "application/json",
    "Content-Type": "application/json"
}

response = requests.put(url, headers=headers, json={
  "locations": [
    {
      "country": "string",
      "language": "string",
      "location_id": 0
    }
  ],
  "keywords": [
    {
      "keyword": "string",
      "tags": ["string"]
    }
  ]
})
print(response.json())

const response = await fetch("https://api.ahrefs.com/v3/management/project-keywords", {
  method: "PUT",
  headers: {
    "Authorization": "Bearer $AHREFS_API_KEY",
    "Accept": "application/json",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
  "locations": [
    {
      "country": "string",
      "language": "string",
      "location_id": 0
    }
  ],
  "keywords": [
    {
      "keyword": "string",
      "tags": ["string"]
    }
  ]
})
});

const data = await response.json();
console.log(data);

body := []byte(`{
  "locations": [
    {
      "country": "string",
      "language": "string",
      "location_id": 0
    }
  ],
  "keywords": [
    {
      "keyword": "string",
      "tags": ["string"]
    }
  ]
}`)
req, _ := http.NewRequest("PUT", "https://api.ahrefs.com/v3/management/project-keywords", bytes.NewBuffer(body))
req.Header.Set("Authorization", "Bearer $AHREFS_API_KEY")
req.Header.Set("Accept", "application/json")
req.Header.Set("Content-Type", "application/json")

resp, _ := http.DefaultClient.Do(req)
defer resp.Body.Close()

data, _ := io.ReadAll(resp.Body)
fmt.Println(string(data))

响应

200 OK

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