Twitoaster API: conversation/search
Returns the 20 most recent (or revelant) conversations that match the specified query. If none, a 404 error is returned.
Formats URLs
JSON http://api.twitoaster.com/conversation/search.json
PHP http://api.twitoaster.com/conversation/search.php_serial
XML http://api.twitoaster.com/conversation/search.xml
Parameters
HTTP method is GET and parameter(s) must be UTF-8 & URL encoded.
Required parameter:
query Search query. The NOT (!), OR (|) and PHRASE (") operators are supported.
Optional parameters:
page Specifies the page of results to retrieve.
show_replies Includes conversation replies. Use true or false.
user_id Search only in conversations started by this user.
screen_name Search only in conversations started by this user.
in_titles_only Search only in conversations titles (first tweet). Use true or false.
in_urls_only Search only in URLs. Use true or false. Must be used in conjuction with in_titles_only and user_id (or screen_name) parameters.
sort_by_revelance Sort by revelance instead of date. Use true or false.
Response
Matching Conversation(s), in the requested format. Each conversation is represented using the following structure:
thread first tweet, which received all the replies:
url
id
title
content
created_at conversation (first tweet) date. 2 formats available:
datetime_gmt
unix_timestamp
last_reply_at last reply date. 2 formats available:
datetime_gmt
unix_timestamp
stats number of replies, retweets, links and images in the conversation:
total_mentions
total_replies
total_retweets
distinct_users
links
images
user author of the conversation (first tweet):
url
id
screen_name
profile_image_url
replies all mentions (replies and retweets), if any:
reply (for each replies / retweets)
type
url
id
content
in_reply_to_status_id
created_at reply date. 2 formats available:
datetime_gmt
unix_timestamp
user author of the conversation (first tweet):
url
id
screen_name
profile_image_url