| 
  • If you are citizen of an European Union member nation, you may not use this service unless you are at least 16 years old.

  • You already know Dokkio is an AI-powered assistant to organize & manage your digital files & messages. Very soon, Dokkio will support Outlook as well as One Drive. Check it out today!

View
 

FrontPage

Page history last edited by Damon Cortesi 14 years, 4 months ago

TweepSearch API Documentation

 

API Overview

The TweepSearch API is available to developers wishing to query the TweepSearch database in a programmatic fashion. The API, like the website, supports a number of search operators, returns stemmed results unless otherwise specified, can search specific fields. This document has four main sections:

 

 

Formats

You can request output in XML as well as JSON. If developing a web application, JSONP is available as well. An example of this can be found on @dacort's blog post about the TweepSearch API.

 

Resources

Queries can be issued against all profiles indexed, or a specific user's friends and/or followers:

 

Search all profiles - http://api.tweepsearch.com/search.xml 

Search a user's friends and followers - http://api.tweepsearch.com/search/{username}.xml

 

Rate Limiting

Requests are rate-limited by default to 60-100 requests/hour depending on server load. For increased levels of access or batch queries, please contact dacort [at] tweepsearch.com

 


Parameters

  • query: Required when searching all profiles. The search query to execute. Details on search operators are below.
  • page: Optional. The page number (starting at 1) to return.
  • count: Optional. The number of results to return per page, up to a max of 100.
  • sort: Optional. The field by which to sort the results. The following fields are supported:
    • last_tweet_at: Default: most recent first.
    • screen_name: Default: a-z.
    • followers_count: Default, descending.
    • friends_count: Default, descending.

Any of these sort fields can be reversed by appending "_reverse" to the field.

 

 

Search Operators

TweepSearch supports basic search operators including the following:

 

Search Fields

TweepSearch allows you to search specific fields of the Twitter profile. Supported fields include the following: 

 

User-specific Searches

TweepSearch allows advanced queries to search through a user's friends and/or followers. By default a search on a specific user searches both their friends and followers.