Current service notices

API only

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.

Query parameters

outputstring

The output format.

Allowed values:jsonphp

Responses

noticesarray<object>

eventsarray<object>

The notice updates, ordered from most recent to oldest.

statusstring

The notice status.

Allowed values: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.

Parameters

output

API keyRequired

Request

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))

Response

200 OK

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