Notes on API/userscript to improve Twitter 'Notifications Timeline'

twitter-notification-tweets-api.md

Notes on API/userscript to improve Twitter 'Notifications Timeline'

Table of Contents

• Tools/Libraries/Etc
• Unsorted
• See Also

Tools/Libraries/Etc

• https://github.com/fa0311/TwitterFrontendFlow

  • Unofficial Client for Twitter Internal API

• https://github.com/fa0311/twitter-openapi-typescript

  • Implementation of Twitter internal API (Twitter graphql API) in TypeScript

• https://github.com/fa0311/twitter-openapi

  • OpenAPI(Swagger) specification of Twitter Internal API (Twitter graphql API)

• https://github.com/fa0311/TwitterInternalAPIDocument

  • Reverse engineering of the web version of Twitter.

• https://github.com/prinsss/twitter-web-exporter

  • Export tweets, bookmarks, lists and much more from Twitter(X) web app.

  • https://greasyfork.org/en/scripts/492218-twitter-web-exporter

Unsorted

On Twitter, from my notifications page:

• https://twitter.com/notifications

When I click on the 'New post notifications for...' section, I am taken to a new page:

• https://twitter.com/i/timeline

As part of this page, an API call is made to fetch the tweets to be shown:

• https://twitter.com/i/api/2/notifications/device_follow.json?include_profile_interstitial_type=1&include_blocking=1&include_blocked_by=1&include_followed_by=1&include_want_retweets=1&include_mute_edge=1&include_can_dm=1&include_can_media_tag=1&include_ext_has_nft_avatar=1&include_ext_is_blue_verified=1&include_ext_verified_type=1&include_ext_profile_image_shape=1&skip_status=1&cards_platform=Web-12&include_cards=1&include_ext_alt_text=true&include_ext_limited_action_results=true&include_quote_count=true&include_reply_count=1&tweet_mode=extended&include_ext_views=true&include_entities=true&include_user_entities=true&include_ext_media_color=true&include_ext_media_availability=true&include_ext_sensitive_media_warning=true&include_ext_trusted_friends_metadata=true&send_error_codes=true&simple_quoted_tweet=true&count=20&ext=mediaStats%2ChighlightedLabel%2ChasNftAvatar%2CvoiceInfo%2CbirdwatchPivot%2CsuperFollowMetadata%2CunmentionInfo%2CeditControl

This returns JSON data, from which we can extract the Tweets, and sort them by post time with something like jq:

pbpaste | jq '.globalObjects.tweets | to_entries | sort_by(.value.created_at | strptime("%a %b %d %H:%M:%S %z %Y")) | reverse | from_entries' | subl

This data will then look something like this:

{
  "1734010714510049396": {
    "created_at": "Mon Dec 11 00:42:25 +0000 2023",
    "id": 1734010714510049300,
    "id_str": "1734010714510049396",
    "full_text": "Don’t be S-A-D! https://t.co/fkHsvfwuGG",
    "truncated": false,
    "display_text_range": [
      0,
      15
    ],
    "entities": { /* ..snip.. */ },
    "extended_entities": { /* ..snip.. */ },
    "source": "<a href=\"http://twitter.com/download/iphone\" rel=\"nofollow\">Twitter for iPhone</a>",
    "in_reply_to_status_id": null,
    "in_reply_to_status_id_str": null,
    "in_reply_to_user_id": null,
    "in_reply_to_user_id_str": null,
    "in_reply_to_screen_name": null,
    "user_id": 44196397,
    "user_id_str": "44196397",
    "geo": null,
    "coordinates": null,
    "place": null,
    "contributors": null,
    "is_quote_status": false,
    "retweet_count": 5203,
    "favorite_count": 56940,
    "reply_count": 3883,
    "quote_count": 410,
    "conversation_id": 1734010714510049300,
    "conversation_id_str": "1734010714510049396",
    "conversation_muted": false,
    "favorited": false,
    "retweeted": false,
    "possibly_sensitive": false,
    "lang": "en",
    "ext": {
      "superFollowMetadata": {
        "r": {
          "ok": {}
        },
        "ttl": -1
      }
    }
  },
  // ..snip..
}

From that info (and matching against the DOM itself), it should be possible to implement a userscript/similar that can:

• mark where the last tweet I saw was (both automatically, and manually)
• hide/dim tweets older than that
• tell me how many tweets there are till I am 'caught up'
• etc

See Also

• Twitter JavaScript scripts / etc (0xdevalias' secret gist)
• Sorting Twitter URLs (0xdevalias' gist)