Today, we are launching new Bookmarks endpoints that enable you to create, manage, and retrieve Bookmarks using the Twitter API v2. This has been among the most common API feature requests, and we’re excited that these endpoints will enable a number of new, highly requested use-cases.
Bookmarks are a core feature of the Twitter app that allows you to “save” Tweets and easily access them later. The Bookmarks feature has long been available in the Twitter app, but until now, there haven’t been endpoints that support Bookmarks via the API. We heard your feedback that Bookmarks functionality was missing from the v1.1 API and we know this is an area where people on Twitter want to see developer-built solutions.
With the Bookmarks lookup endpoint, you will be able to get back up to 800 of your most recent bookmarked Tweets. Additionally, there is a per-user rate limit of 50 requests per 15 minutes for the POST and DELETE methods of manage Tweets and a per-user rate limit of 180 requests per 15 min window for the GET method of Bookmarks lookup.
Get started
To get started and learn more about the new Bookmarks endpoints, check out our documentation. To use this endpoint, you must authenticate these endpoints using an OAuth 2.0 Authorization Code Flow with PKCE.
Potential use cases
Based on the feedback we’ve heard from people on Twitter, here are just some of the use-cases you might consider building:
Add Bookmarks to your to-do list
We’ve heard that many use their Bookmarks as a to-do list of sorts. If you are one of those people, you can build a solution using the API of your favorite project management tools, such as Trello or Notion, and then use Bookmarks lookup to get a list of Bookmarks to add.
Check out our Binder Notebook that walks you through how to add your bookmarked Tweets to a Notion page, and our Glitch app where you can try out this functionality yourself.
Jam out to songs from your Bookmarks
Have you ever wanted to create a playlist from songs in your bookmarked Tweets? We’ve used the Spotify API to create a Glitch app which allows you to grab songs from your Bookmarks and recent search if you don’t have any songs in your playlist.
Bookmark organizer
We know that many people want to categorize and organize their Bookmarks more easily. Using Bookmarks lookup and Tweet annotations, you can build an application that categorizes your Bookmarks for you based on the Tweet annotations of each Tweet.
A monthly digest of your Bookmarks
People often use Bookmarks to keep track of key moments or important Tweets. For example, a lot of us on the Developer Platform team use Bookmarks as a way of saving feedback on the Twitter API to share with our team.
Using an email API, like Google’s Gmail API, and Bookmarks lookup you can create a monthly email of your bookmarked Tweets. This monthly digest could be a way to share exciting Tweets with a small group of friends, coworkers or even to remind yourself of your recently bookmarked Tweets.
Search for top Tweets on specific topics from the past week
Many people use Twitter to search for discussions on specific topics. Bookmarks offer a way for people to save those Tweets and revisit them later.
Using a combination of recent search and the POST method of manage Bookmarks, you could create an application that allows you to search for topics you are interested in via keyword or hashtag, and then Bookmark the top Tweets matching your query.
Create a reading list for your commute
Some people use Bookmarks as a reading list to remind them of articles to read, for example, on their commute home from work. You can use Bookmarks lookup to create a list of your Bookmarks for the day and use an API such as Twilio to get a text message shortly before your commute.
We can’t wait to see what you build
This is far from an exhaustive list of what you can build with the Bookmarks endpoints, but hopefully, they act as a starting place or inspiration for what you’ll build next!
We are eager to see what you build. Be sure to let us know on the forums if you run into any trouble along the way, and Tweet us at @TwitterDev to let us know what you build!