删除关键词标签

仅限 API

PUT/v3/management/project-keywords-tags-delete

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

请求正文

tagsarray<string>Required

要从关键词中移除的标签列表。

keywordsarray<object>Required

要更新的关键词列表。你可以使用 "Locations and languages" 端点获取国家/地区代码、语言代码和位置 ID。

keywordstringrequired

要更新的关键词。

countrystring

国家代码。

languagestring

语言代码。

location_idinteger

地区 ID。

project_idintegerRequired

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

outputstring

输出格式。

Allowed values:jsonphp

响应

keywordsarray<object>

keywordstring

添加到项目的关键词。

languagestring

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

language_codestring

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

locationstring

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

location_idinteger

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

tagsarray<string>

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

请求正文

{
  "tags": ["string"],
  "keywords": [
    {
      "keyword": "string",
      "country": "string",
      "language": "string",
      "location_id": 0
    }
  ],
  "project_id": 0,
  "output": "json"
}

API密钥

请求

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

import requests

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

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

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

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

body := []byte(`{
  "tags": ["string"],
  "keywords": [
    {
      "keyword": "string",
      "country": "string",
      "language": "string",
      "location_id": 0
    }
  ],
  "project_id": 0,
  "output": "json"
}`)
req, _ := http.NewRequest("PUT", "https://api.ahrefs.com/v3/management/project-keywords-tags-delete", 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": "string",
      "language_code": "string",
      "location": "string",
      "location_id": 0,
      "tags": ["string"]
    }
  ]
}