search

Returns tweets that match a specified query.

URL: http://search.twitter.com/search.{{response_format}}

API rate limited: 1 call per request

HTTP Method:

Response Format:

Authenticate Request:

Required Parameters:

Optional Parameters:

callback:
Only available for JSON format. If supplied, the response will use the JSONP format with a callback of the given name.
lang:
Restricts tweets to the given language, given by an ISO 639-1 code.
rpp:
The number of tweets to return per page, up to a max of 100.
page:
The page number (starting at 1) to return, up to a max of roughly 1500 results (based on rpp * page. Note: there are pagination limits.
since_id:
Returns tweets with status ids greater than the given id.
geocode:
Returns tweets by users located within a given radius of the given latitude/longitude, where the user's location is taken from their Twitter profile. The parameter value is specified by "latitide,longitude,radius", where radius units must be specified as either "mi" (miles) or "km" (kilometers). Note that you cannot use the near operator via the API to geocode arbitrary locations; however you can use this geocode parameter to search near geocodes directly.
show_user:
When true, prepends ":" to the beginning of the tweet. This is useful for readers that do not display Atom's author field. The default is false.

Notes: Show

Query strings should be URL encoded.
Queries are limited 140 URL encoded characters.
The since_id parameter will be removed from the next_page element as it is not supported for pagination. If since_id is removed a warning will be added to alert you.
This method will return an HTTP 404 error if since_id is used and is too old to be in the search index.
If you are having trouble constructing your query, use the advanced search form to construct your search, then add the format. For example http://search.twitter.com/search?q=twitter would become http://search.twitter.com/search.json?q=twitter

* You need to Sign in with Twitter first to make authenticated request.

Twitter API Explorer