Current service notices

API uniquement

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.

Paramètres de requête

outputstring

The output format.

Valeurs autorisées:jsonphp

Réponses

noticesarray<object>

eventsarray<object>

The notice updates, ordered from most recent to oldest.

statusstring

The notice status.

Valeurs autorisées: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.

Paramètres

output

Clé APIObligatoire

Requête

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

Réponse

200 OK

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