Blog

Tweetbot URL scheme

We’ve gotten a few questions on the URL scheme for Tweetbot and I wanted to have a post to point other developers to. This will be updated as we make changes for new versions. If you aren’t a developer please feel free to move on, not much to see here.

Valid as of version 1.0.2

  • tweetbot://<screenname>/timeline
  • tweetbot://<screenname>/mentions
  • tweetbot://<screenname>/retweets
  • tweetbot://<screenname>/direct_messages
  • tweetbot://<screenname>/lists
  • tweetbot://<screenname>/favorites
  • tweetbot://<screenname>/search
  • tweetbot://<screenname>/search?query=<text>
  • tweetbot://<screenname>/status/<tweet_id>
  • tweetbot://<screenname>/user_profile/<profile_screenname>
  • tweetbot://<screenname>/post
  • tweetbot://<screenname>/post?text=<text>

The <screename> argument is optional. You may include it to go to a specific account or leave it blank and either the current or default user account will be chosen instead. As usual all query <text> should be URL encoded and other then that everything should be pretty obvious.

Valid as of version 1.3

  • tweetbot://<screenname>/post?text=<text>&callback_url=<url>&in_reply_to_status_id=<tweet_id>
  • tweetbot://<screenname>/search?query=<text>&callback_url=<url>
  • tweetbot://<screenname>/status/<tweet_id>?callback_url=<url>
  • tweetbot://<screenname>/user_profile/<screenname|user_id>?callback_url=<url>
  • tweetbot://<screenname>/follow/<screenname|user_id>
  • tweetbot://<screenname>/unfollow/<screenname|user_id>
  • tweetbot://<screenname>/favorite/<tweet_id>
  • tweetbot://<screenname>/unfavorite/<tweet_id>
  • tweetbot://<screenname>/retweet/<tweet_id>

The argument callback_url is an URL encoded URL that will be opened in Safari once the Post view closes.

Valid as of version 1.4

  • tweetbot://<screenname>/list/<list_id>?callback_url=<url>

Any questions stick them below and I’ll update the docs as needed.

Retweet this Article

6 Comments:

Permalink
  • David Helms said:
  • May 6th, 2011

Hi,
Attempting to use this URL scheme and I don’t seem to be getting good results.
From safari, if I open this url…

tweetbot:///post?text=abc

…tweetbot opens, the ‘New Tweet’ composition view is opened, but my content, ‘abc’ is not in the editable view.

Appreciate any pointers on how to get this to work.
Thanks,
david

Permalink
  • David Helms said:
  • May 6th, 2011

Uh, yea, so of course, as soon as I submit the previous comment/question I realize I’m probably not running the latest version of tweetbot. So, post-update, all is swell. Problem solved.

Thanks,

david

Permalink

Tweetbot Updated version is awesome. I hope you guys can add more useful features.

Permalink
  • Mike Cmrk said:
  • May 25th, 2011

Is there a way to make a bookmarklet with those schemes?

Thanks.

Permalink
  • E-WA said:
  • May 26th, 2011

For posting URL and title of a web page you are viewing with Safari, try this code as a bookmarklet;

javascript:window.location=’tweetbot:///post?text=[link] ‘
encodeURIComponent(document.title)‘ : ‘+encodeURIComponent(window.location.href)

Permalink
  • E-WA said:
  • May 26th, 2011

To install the above as a bookmarklet;

- Copy the code in the above post
- Make a new Safari bookmark
- Rename it as you like (for example “Post with Tweetbot”) and save
- Go to Bookmark screen, tap “Edit”, then tap “>” in the right of the new bookmark
- Paste the copied code into the second line, and save