With Twittelator's API, you can simply launch Twittelator Free or Pro, you can compose a new message, and if you are running a server checking for a user’s mentions, you can launch Twittelator Pro and show mentions or messages. Or you might be tracking a search query and have it load a search on launch.
Anyone can experiment with this API in Mobile Safari by entering valid Twittelator Pro links - ie twit://
Simply open the url "twit://" to launch Twittelator Pro in Browser or via code:
NSURL* url = [NSURL URLWithString:@"twit://"];
[[UIApplication sharedApplication] openURL:url]; New messages or replies can created by creating URL's of this form:
twit:///post?<KEY>=<VALUE>&<KEY2>=<VALUE2>...&<KEYn>=<VALUEn>
where valid <KEY>'s and <VALUE>'s are:
Required:
message RFC 2396 percent escaped* sentence less than 141 characters long
Optional:
isDirect 1 if this is a direct message (private), 0 if new tweet or reply replyToScreenName valid recipient's screen name replyToStatusID status id of tweet to respond to
Examples:
new simple tweet: twit:///post?message=Twittelator%20Pro%20rocks%20the%20house
new direct message to user @twittelator:
twit:///post?message=Hey%20Dude&isDirect=1&replyToScreenName=twittelator Launch Twittelator Pro and have it immediately load just new messages:
twit:///directs
Optional:
twit:///directs?<KEY>=<VALUE>&<KEY2>=<VALUE2>...&<KEYn>=<VALUEn>
where valid <KEY>'s and <VALUE>'s are:
id id string of this direct message
from screen name of sender to screen name of account to load on launch
Examples:
DM sent by @peter to @evan twit:///directs?id=28716742&from=peter&to=evan Launch Twittelator Pro and have it immediately load just new mentions:
twit:///mentions
Optional:
twit:///mentions?<KEY>=<VALUE>&<KEY2>=<VALUE2>...&<KEYn>=<VALUEn>
where valid <KEY>'s and <VALUE>'s are:
id id string of this direct message
from screen name of sender to screen name of account to load on launch
Examples:
@mention sent by @peter to @evan twit:///mentions?id=28716742&from=peter&to=evan Launch Twittelator Pro and have it immediately load just friends timeline:
twit:///friends
Launch Twittelator Pro and have it immediately load this search query:
twit:///search?q=<EXACT_SEARCH_QUERY>
Examples: search for "Harry Potter" twit:///search?q=Harry+Potter search for tweets from @twittelator with links in them twit:///search?q=&from=twittelator&filter=links
Using http://search.twitter.com/advanced, you can quickly create valid <EXACT_SEARCH_QUERY>'s!
Note: do not append the number of returned pages (the rpp parameter) because Twittelator automatically sets that depending on the user's preferences.
To launch Twittelator Pro and have it immediately display the Search panel, simply use:
twit:///search
Launch Twittelator Pro and have it immediately load a user's info - great for following!
twit:///user?screen_name=<TWITTER_NAME>
or twit:///user?id =<TWITTER_USER_ID>
Examples:
get info on "Twittelator" twit:///user?screen_name=twittelator twit:///user?id=14793018 Launch Twittelator Pro and have it immediately load a given tweet
twit:///status?id =<TWEET_ID>
Example:
twit:///status?id=9043183075
Launch Twittelator Pro and have it immediately load a list
twit:///list?slug =<LIST_SLUG>
Example:
twit:///list?slug=twittelator/chess
Launch Twittelator Pro and have it immediately load an old-school editable retweet Requires both screen_name (author of original status) and message:
twit:///quote?screen_name=<SCREEN_NAME>&message=<MESSAGE>
Examples:
twit:///quote?screen_name=twittelator&message=Hey%20Now
Launch Twittelator Pro and have it immediately retweet a status
twit:///retweet?id=<STATUS_ID>
Example:
twit:///retweet?id=<STATUS_ID>
*For more info, see Apple documentation for CFURLCreateStringByAddingPercentEscapes
** available in Twittelator Pro V3.1 and later | 
