TWENTH

Twenth Api (BETA) Documentation

Your API Details

You must sign in before you can generate API Keys

Current Twenth API's

Type Url Input Parameters Return Data Rate Limited
POST http://twenth.com/api/posts/create
  • secret_key
  • secret_token
  • response
  • message
  • message
  • url
  • tweet
Yes

Status Codes

1 - Successful

Your tweet has been shortened successfully.

2 - Invalid API Details

You provided an invalid secret_token and secret_key for the request.

3 - Hit Rate Limit

The current rate limit is 100 requests per hour, this is on a rolling period.

4 - Bad Request, No Post Data

You haven't sent any post data in the request you made.

5 - You haven't provided a message

You need to provide us with a message in order for us to process your request.

Input Parameters

secret_key(*) : This is a 15 digit string used to authenticate you as a user of the API.

secret_token(*) : This is a 20 digit string that works in hand with the secret_key. Used in the authentication process.

response : You can chose from either 'xml' or 'json', it is set to JSON by default, this will determine the return format of your request.

message(*) : This is the long message that you want to tweet.

Messages marked with : (*) are required input parameters

Return Parameters

message : This is the long message that you requested to be tweeted.

url : This is the url to your tweet on Twenth.

tweet : This is a formatted 140 character tweet ready to be posted to Twitter, it has the url to the Twenth message page appended on the end.

Code Examples

Twenth API Call PHP Example

We Would Love To
Hear From You!

Have a suggestion or found a bug? We want to hear from you! Please fill in the form to your right and we'll happily hear what you have to say.

  • Comments On Twitter Posts!

    January 31st 2013

    Twenth now allows you to add comments on twitter posts, all you have to do is sign in with your Twitter account!

  • Twenth API (BETA) Launched!

    January 25th 2013

    Twenth has launched the BETA version of it's API, please contact us for any feedback or extra features you would like to see, your feedback is welcomed!

  • Mobile Website!

    January 21st 2013

    Twenth has now launched a mobile version of the website, it is accessible and user friendly on all smart phones!

  • New website launched!

    January 19th 2013

    Hurray! We've finally launched our new website - and we all love it! What do you think? Let us know - we'd love to hear from you!

  • Working on New Stuff!

    January 17th 2013

    Here at Twenth we love to experiment, whilst you're all busy tweeting (and so you should) we're working on some great social apps which we think you'll love!