<< Back to Twitter API Documentation

trends/weekly

Returns the top 30 trending topics for each day in a given week.

method status | report a bug

URL:

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

Format: 

json

HTTP Method:

GET

Requires Authentication (about authentication):

false

API rate limited (about rate limiting):

true

Parameters:

• date: Optional. Permits specifying a start date for the report. The date should be formatted YYYY-MM-DD.

  • Example: http://search.twitter.com/trends/weekly.json?date=2009-03-19

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

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

Response (about return values): 

          JSON example (truncated):

{"trends":{"2009-03-18":[{"query":"#sxsw OR SXSW","name":"#sxsw"},... truncated ...}],... truncated ...},"as_of":1239656690}

Usage examples: 

cURL (about cURL):

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

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

<< Back to Twitter API Documentation