App Logo
x.com

Get X notifications

List the logged-in account's Notifications > All tab (not just mentions) — follows, likes, retweets, replies and other notification types X surfaces there. Returns per notification: id, type (a stable X-internal event key, e.g. users_followed_you), icon, text (the rendered notification sentence), url (the notification's target link, if any), timestamp_ms, and users (the accounts referenced in the notification text, with id/handle/name). Scrolls until count is met or the feed dries up.

Input

count optional

Max notifications to return. Default 50.

Default: 50

Output

count required

Number of notifications returned. 0 is a first-class outcome (no notifications).

notifications required

Start building not clicking