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