<< Back to Twitter API Documentation

trends/current

Returns the current top 10 trending topics on Twitter.  The response includes the time of the request, the name of each trending topic, and query used on Twitter Search results page for that topic.

method status | report a bug

URL:

http://search.twitter.com/trends/current.format

Format: 

json

HTTP Method:

GET

Requires Authentication (about authentication):

false

API rate limited (about rate limiting):

1 call per request 

Parameters:

• exclude: Optional. Setting this equal to hashtags will remove all hashtags from the trends list.

  • Example: http://search.twitter.com/trends/current.json?exclude=hashtags

Response (about return values): 

          JSON example (truncated):

{"trends":{"2009-04-13 20:51:25":[{"query":"#amazonfail","name":"#amazonfail"},... truncated ...]},"as_of":1239655885}

Usage examples: 

cURL (about cURL):

curl http://search.twitter.com/trends/current.json

          Do you have an example to share in the language of your choice? Please share!

<< Back to Twitter API Documentation