API Use Cases

Scenario: Twitter Ranking Site

You have a site where you rank Tweeters and display individual user profiles. Example sites in this category include Klout, Twitter Grader, and Twitter Counter.

I’m looking for my personal score/rank.

  • I enter my name in your search bar.
  • You look up if I’m in SponsoredTweets via the API.
  • You get back that I do not have a SponsoredTweets account.
  • You dynamically add a button to the page that says “Get your Tweets Sponsored!”
  • Using your referral link on the button, you direct me to the SponsoredTweets signup page.
  • If I signup, you become my referrer and make a referral fee for every offer I take!
  • Note that you will get credit for any new user that signs up by clicking this link. So if I am checking another users rank and click the button the referrer still gets credit.

tweeter_sponsor

I’m researching influential Tweeters.

  • I enter the name of an influential tweeter in your search bar.
  • You look up if that Tweeter is in SponsoredTweets via the API.
  • You get back that the tweeter does have a SponsoredTweets account.
  • You dynamically add a button on the page that says “Sponsor”
  • Using your referral link, you direct me to a profile sponsor page.
  • If an advertiser completes a transaction from that page you will be paid for that transaction.
  • If the advertiser is also a new user you will continue to get paid for a period of 2 years.

advertiser_sponsor

Scenario 2: Twitter Lists

You have a site that displays list or groups of tweeters based on categories or keywords. Examples sites in the category include Twitterholic and Celebritytweet. The use case for this type of site is very similiar to a Twitter Ranking site. You can choose to display a button on an individual profile or next to each listing.

Scenario 3: Twitter Client

You have an application that people use to send personal tweets or manage a corporate Twitter accounts. Examples of these types of app are Tweetie, HootSuite and CoTweet.

I’m a personal Tweeter using your app.

  • I sign into my Twitter account.
  • You look up if I’m in SponsoredTweets via the API.
  • You get back that I do not have a SponsoredTweets account.
  • You dynamically add a button to the page that says “Join SponsoredTweets!”
  • Using your referral link on the button, you direct me to the SponsoredTweets sign up page.
  • If I sign up, you become my referrer and make a referral fee for every offer I take!
  • After I sign up the button goes away.

I’m a corporate Tweeter using your app.

  • I engage with Tweeters talking about my brand.
  • You look up if that Tweeter is in SponsoredTweets via the API.
  • You get back that the tweeter does have a SponsoredTweets account.
  • You dynamically add a button in the app that says “Sponsor @johndoe for $XX.XX”
  • Using your referral link, you direct me to a profile sponsor page.
  • If an advertiser completes a transaction from that page you will be paid for that transaction.
  • If the advertiser is also a new user you will continue to get paid for a period of 2 years.
Be Sociable, Share!

API