Table Of Contents
Limitations
APIs
Demonstrations
Libraries
Incomplete Data Set
Due to limitations placed on us by Twitter, our service is not an entire data set. This means that we may not have a reply even if there is one. This is not an error with the system, but a limitation from the beginning.
Inconsistent Data Appearances
Data may be inconsistent with our front page. Our front page is generated periodically, so may not be an accurate representation of responses you will receive from API calls.
Misuse of HTTP Status Codes
We are aware that we don't correctly use HTTP status codes when responding, it's on our list for improvements.
Rate Limiting
Currently, there are no limits on calls. However, should we feel that the system is being abused, we have the ability to add limits.
Lookup Replies
Description
This API allows access to all replies given to a particular tweet based on the ID.
URL
http://reply.api.twitterfall.com/lookup.json
Parameters
id : The status_id of the tweet
callback : The JSONP callback function (optional)
Valid Result
response : "ok"
id: The status_id of the tweet
result : An array of replies
date_created : The date string of the tweet's creation
last_modified : The date string of the last reply
Invalid Result
response : "error"
reason : A string explaining the error
Example
http://reply.api.twitterfall.com/lookup.json?id=2020860611
Top Replies
Description
This API allows access to the top 20 replied tweets within the last day.
URL
http://reply.api.twitterfall.com/chart.json
Parameters
count : The number of top replies. Maximum at 20.
callback : The JSONP callback function (optional)
Valid Result
response : "ok"
result : An array of key data pairs consisting of a status_id and number of replies to that status_id.
Invalid Result
response : "error"
reason : A string explaining the error
Example
http://reply.api.twitterfall.com/chart.json?count=15
Spider
Description
This API allows access to all replies and all recursive replies based on a particular tweet ID.
URL
http://reply.api.twitterfall.com/spider.json
Parameters
id : The status_id of the tweet
maxdepth : The maximum depth of replies to traverse (optional, default is infinite)
callback : The JSONP callback function (optional)
Valid Result
response : "ok"
result : A nested array of {id, result} tuples, where result is another nested array. If maxdepth is used and there are replies deeper than maxdepth the array will contain the string "more"
Invalid Result
response : "error"
reason : A string explaining the error
Example
http://reply.api.twitterfall.com/spider.json?id=2121688715
Stream
Description
This API allows access to a stream of replies based on a number of tweet IDs. The stream will produce replies as they occur.
This is a long-polling API call. It will not return any result until data is ready, and will keep the connection open until this happens.
URL
http://reply.api.twitterfall.com/stream.json
Parameters
id : The id of the tweet (multiple queries allowed)
since : Return tweets with a later id than this (optional)
callback : The JSONP callback function (optional)
Valid Result
response : "ok" | "truncated"
result : An array of status objects, as per the Twitter REST API. Unless using the since parameter this will only ever be one status. When using the since parameter, the id you specify must be a valid reply id (e.g. it must already be a reply to one of the ids you specify) otherwise you will get the error "since parameter not valid".
Invalid Result
response : "error"
reason : A string explaining the error. When using multiple id parameters, you will only receive one error
Notes
stream.json will only return a maximum of 10 statuses at a time. If your since id was more than 10 statuses ago, you will receive the response "truncated" and only receive the most recent 10. This is because stream.json is not meant for accessing replies, it is meant for streaming replies in realtime.
Example
http://reply.api.twitterfall.com/stream.json?id=2858964357&id=2856629639
First Demonstration
Description
Using both the Top Replies API and the Streaming API we can show you the responses to the top 20 most replied tweets as they come through in real-time.
URL
http://replies.twitterfall.com/demo1.html
Author
@Jalada
Twitterfall Replies
Description
Using the Lookup Replies API we can show you replies to nearly all tweets from within Twitterfall.
URL
http://twitterfall.com/from:mileycyrus
Author
@x5315 and @Jalada
C# Wrapper
Description
A C# Wrapper for all API calls. Currently only works on Mono, because .Net is poorly written (i've been told).
URL
http://replies.twitterfall.com/libraries/C-sharp.zip
Author
@Tinned_Tuna
Erlang Wrapper
Description
A Erlang Wrapper for all API calls.
URL
http://replies.twitterfall.com/libraries/Erlang.zip
Author
@User_4574
Java Wrapper
Description
A Java Wrapper for all API calls.
URL
http://replies.twitterfall.com/libraries/Java.zip
Author
@Tinned_Tuna
PHP Wrapper
Description
A PHP Wrapper for all API calls.
URL
http://replies.twitterfall.com/libraries/PHP.zip
Author
@x5315
Python Wrapper
Description
A Python Wrapper for all API calls.
URL
http://replies.twitterfall.com/libraries/Python.zip
Author
@Tinned_Tuna