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:
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
*For more info, see Apple documentation for CFURLCreateStringByAddingPercentEscapes
** available in Twittelator Pro V3.1 and later | 
