client.content.listNotices()
The notices the website is showing right now, best first. Public, cached for a minute at the edge. An empty list means no banner.
listNotices(): Promise<APIResponse<{ notices: SiteNotice[] }>>- stringheader
Optional. Without a key this endpoint answers under the public policy; a key raises your limits and unlocks plan-gated fields.
Authorization: Bearer <key>is accepted in its place.
- object
The response payload.
- SiteNotice[]
Published notices inside their display window, best first: highest priority, then newest.
- string
Row id of the notice. The website keys its dismissal on this, so a new notice is seen even by a reader who dismissed the last one.
- string
Short label shown before the message.
- string
The sentence shown in the banner.
- string
A second line, shown under the highlight where one is set.
- NoticeVariant
How prominently a site notice is shown.
- string | null
Text of the call to action, or null when the banner has none.
- string | null
Where the call to action goes.
- integer
Higher sorts first. Ties break on newest.
- string | null
When the notice becomes visible. Null means immediately.
- string | null
When it stops being shown. This is why notices are rows rather than copy: an end date is the only version of "take this down later" that does not rely on somebody remembering.
- 400
VALIDATION_ERROR - 429
RATE_LIMITED - 500
INTERNAL_ERROR
- Minimum tier
- Explorer+
- Monthly quota
- 200/mo
- Rate limit
- 10/min
- Daily cap
- 50
Figures shown are for this endpoint's minimum tier. Higher tiers raise every limit.