Bookmarksy.io 🚀

One of the most important features of bookmarksy.io is it’s ability to reach out to Twitters API and retrieve a given users bookmarks.

Getting a list of users bookmarks is the easy bit. You can make a call to

https://api.twitter.com/2/users/:id/bookmarks

and what is returned is a list that looks something like this:

{
    "data": [
        {
            "created_at": "2022-11-11T18:18:36.000Z",
            "edit_controls": {
                "edits_remaining": 5,
                "is_edit_eligible": false,
                "editable_until": "2022-11-11T18:48:36.000Z"
            },
            "text": "Build a $50 info-product in one day using this process:\n\n(Probably shouldn't give this away for free bc later I'm going to sell a guide to this same process for ~$50.)",
            "public_metrics": {
                "retweet_count": 242,
                "reply_count": 85,
                "like_count": 1171,
                "quote_count": 29
            },
            "source": "Tweet Hunter Pro",
            "conversation_id": "1591133306069843979",
            "lang": "en",
            "id": "1591133306069843979",
            "reply_settings": "everyone",
            "possibly_sensitive": false,
            "edit_history_tweet_ids": [
                "1591133306069843979"
            ]
        }
    ],
    "includes": {
        "users": [
            {
                "name": "Rob Lennon 🗯 | Audience Growth",
                "username": "thatroblennon"
            }
        ],
        "tweets": [
            {
                "created_at": "2022-11-11T18:18:36.000Z",
                "edit_controls": {
                    "edits_remaining": 5,
                    "is_edit_eligible": false,
                    "editable_until": "2022-11-11T18:48:36.000Z"
                },
                "text": "Build a $50 info-product in one day using this process:\n\n(Probably shouldn't give this away for free bc later I'm going to sell a guide to this same process for ~$50.)",
                "public_metrics": {
                    "retweet_count": 242,
                    "reply_count": 85,
                    "like_count": 1171,
                    "quote_count": 29
                },
                "source": "Tweet Hunter Pro",
                "conversation_id": "1591133306069843979",
                "lang": "en",
                "id": "1591133306069843979",
                "reply_settings": "everyone",
                "possibly_sensitive": false,
                "edit_history_tweet_ids": [
                    "1591133306069843979"
                ]
            }
        ]
    },
    "meta": {
        "result_count": 1,
        "next_token": "zldjwdz3w6sba13nbs0z2lzml73coscn3mc18c0avxs"
    }
}

And that’s all fine and well. But if I’m dealing with a thread, which most bookmarks tend to be, how do I retrieve all the related tweets?

The twitter documentation speaks of use of recent search or archive search for tweets. This isn’t viable for two reasons:

1. recent search only works on tweets less than seven days old
2. archive search is enrollment based and EXPENSIVE!.

So what’s the solution? Here’s what I’ve implemented to work around this:

assumptions:

• A bookmark is either a single tweet, or a collection (conversation: twitter language) of tweets.
• If a bookmark is a collection of tweets, it can be assumed that this bookmark is a thread.
• Thread tweets are typically created around the same time (roughly < 10 seconds between tweets).

Solution:

Leverage the

https://api.twitter.com/2/users/:id/tweets

endpoint with a request body as such:

{
	since_id: <ID OF BOOKMARKED TWEET>,
	end_time: <CREATED_AT OF BOOKMARKED TWEET + 5 MINS>,
	limit: 100
}

this will retrieve the first 100 tweets published within the first five minutes after the initial tweet.

Then we can filter on those tweets by conversation_id to retrieve the ones associated with our bookmark!

With this solution, we work around the 7 day and archive restrictions. Is it ideal? of course not, but it’s been reliable so far! And unless your bookmark is a thread of over one hundred tweets, there doesn’t appear to be any data loss.

The only drawback is that I will likely end up querying redundant tweets which would eat into my monthly query limit, but we will cross that bridge when we get to it!

https://bookmarksy.io is coming along nicely so far. Hit a couple of snag’s but I will be looking for beta testers soon!

Follow the journey on twitter https://twitter.com/bookmarksy_io or https://twitter.com/brandonkpbailey and join the waitlist! https://brandonkpbailey.substack.com/

Zero to SaaS - Product #1 Bookmarksy.io, the solution

The idea for Bookmarksy.io started with a simple statement:

“I wish I could get an email of my twitter bookmarks every week so I didn’t stop forgetting them. Something like The Morning Brew”

So I went on the internet searching for a solution that might already exist that solves my problem. It didn’t. So I went to work.

Setting up a domain name, email list, landing page, social media, The whole nine yards. But having spoken to some people about this problem, I realize there’s something more here.

It isn’t just difficult to remember to re-visit your twitter bookmarks, the entire concept of bookmarks in twitter is broken! A single stream of un-contextualized tweets or threads, sorted in order of most recently added to least recently added.

A feed that would allow you to categorize, tag and sort these bookmarks more effectively would be much more useful.

After some brainstorming, here’s the feature list I’d like to go to launch with:

• Bookmark aggregation/consolidation
  • Threads condensed to a single, blog post like display with likes, retweets and replies information
• Contextualization
  • Adding categorization and tagging to bookmarks for storage and retrieval
• Bookmark habits/ Analytics
  • Am I actually using my bookmarks in a meaningful way?
• Daily/ Weekly roundup emails
  • The Morning Brew style emails of my bookmarks for low-effort consumption.
• Bookmark cleanup
  • Once I’ve processed my bookmarks in Bookmarksy.io, I can clean them up from my twitter feed.

What do you think? Is this a good idea? Is this something you would use?

As always, if you’d like to be the first to receive updates, sign up to our waitlist https://bookmarksy.io !

As the title suggests, the landing page for BookMarksy.io is live!

Check it out here: https://bookmarksy.io or at https://twitter.com/bookmarksy_io

I use twitter almost daily. I bookmark a bunch of useful information with the intention of coming back to take notes. But I almost never do.

The reason, I think, is because there’s too much friction involved in extracting the important information. So what if I could eliminate that friction?

Enter my first project idea, BookMarksy.io.

A Micro-SaaS app that removes the friction of getting the important information out of your twitter bookmarks.

I’ll share more details in the coming days along with a waitlist! In the mean time, feel free to join the newsletter here: