Stone Design Stone Design
News Download Buy Software About Stone
software
Twittelator API

You can post tweets through Twittelator Pro and much more:
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://

launch
post
• dm
• friends
search
user
status
list
• quote
        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

PreviousTopNext
©1997-2012 Stone Design top