List active announcements
curl --request GET \
--url https://api.social-api.ai/v1/announcements \
--header 'Authorization: <api-key>'const options = {method: 'GET', headers: {Authorization: '<api-key>'}};
fetch('https://api.social-api.ai/v1/announcements', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.social-api.ai/v1/announcements"
headers = {"Authorization": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text){
"count": 1,
"data": [
{
"body": "We are upgrading our database infrastructure.",
"id": "9c1e7f2a-3b4d-4e5f-8a9b-0c1d2e3f4a5b",
"kind": "maintenance",
"link_label": "Status page",
"link_url": "https://status.social-api.ai",
"seen": false,
"title": "Scheduled maintenance",
"window_end": "2026-08-02T04:00:00Z",
"window_start": "2026-08-02T02:00:00Z"
}
]
}{
"error": {
"code": "resource.not_found",
"message": "Account not found",
"meta": {}
}
}Announcements
List active announcements
Returns service announcements that are currently visible, newest first. Each item carries a seen flag for the calling user. window_start and window_end describe the announced maintenance window and are absent for non-maintenance announcements. Free operation, consumes no credits.
GET
/
announcements
List active announcements
curl --request GET \
--url https://api.social-api.ai/v1/announcements \
--header 'Authorization: <api-key>'const options = {method: 'GET', headers: {Authorization: '<api-key>'}};
fetch('https://api.social-api.ai/v1/announcements', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.social-api.ai/v1/announcements"
headers = {"Authorization": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text){
"count": 1,
"data": [
{
"body": "We are upgrading our database infrastructure.",
"id": "9c1e7f2a-3b4d-4e5f-8a9b-0c1d2e3f4a5b",
"kind": "maintenance",
"link_label": "Status page",
"link_url": "https://status.social-api.ai",
"seen": false,
"title": "Scheduled maintenance",
"window_end": "2026-08-02T04:00:00Z",
"window_start": "2026-08-02T02:00:00Z"
}
]
}{
"error": {
"code": "resource.not_found",
"message": "Account not found",
"meta": {}
}
}