Current service notices

仅限 API

GET/v3/keywords-explorer/service-notices

Returns the service notices that are currently displayed in Keywords Explorer. Requests to this endpoint are free and do not consume any API units.

查询参数

outputstring

The output format.

允许的值:jsonphp

响应

noticesarray<object>

eventsarray<object>

The notice updates, ordered from most recent to oldest.

statusstring

The notice status.

允许的值:warningsuccesserrorinfo

messagestring

The notice message.

detailsstring or null

Additional details about the notice update.

happened_atstring (date-time)

The date and time of the notice update.

notice_idstring

The ID of the service notice.

visible_sincestring (date-time)

The date and time when the notice became visible.

visible_untilstring (date-time) or null

The date and time when the notice stops being visible.

参数

output

API密钥必填

请求

curl "https://api.ahrefs.com/v3/keywords-explorer/service-notices" \
  -H "Authorization: Bearer $AHREFS_API_KEY" \
  -H "Accept: application/json"

import requests

url = "https://api.ahrefs.com/v3/keywords-explorer/service-notices"
headers = {
    "Authorization": "Bearer $AHREFS_API_KEY",
    "Accept": "application/json"
}

response = requests.get(url, headers=headers)
print(response.json())

const response = await fetch("https://api.ahrefs.com/v3/keywords-explorer/service-notices", {
  method: "GET",
  headers: {
    "Authorization": "Bearer $AHREFS_API_KEY",
    "Accept": "application/json"
  }
});

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

req, _ := http.NewRequest("GET", "https://api.ahrefs.com/v3/keywords-explorer/service-notices", nil)
req.Header.Set("Authorization", "Bearer $AHREFS_API_KEY")
req.Header.Set("Accept", "application/json")

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

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

响应

200 OK

{
  "notices": [
    {
      "events": [
        {
          "status": "warning",
          "message": "string",
          "details": "string",
          "happened_at": "string"
        }
      ],
      "notice_id": "string",
      "visible_since": "string",
      "visible_until": "string"
    }
  ]
}