GET trends/place

Returns the top 10 trending topics for a specific WOEID, if trending information is available for it.

The response is an array of “trend” objects that encode the name of the trending topic, the query parameter that can be used to search for the topic on Twitter Search, and the Twitter Search URL.

This information is cached for 5 minutes. Requesting more frequently than that will not return any more data, and will count against your rate limit usage.

Resource URL

https://api.twitter.com/1.1/trends/place.json

Resource Information

Response formats
JSON
Requires authentication?
Yes
Rate limited?
Yes
Requests / 15-min window (user auth)
15
Requests / 15-min window (app auth)
15

Parameters

id required

The Yahoo! Where On Earth ID of the location to return trending information for. Global information is available by using 1 as the WOEID.

Example Values: 1

exclude optional

Setting this equal to hashtags will remove all hashtags from the trends list.

OAuth Signature Generator

Sign in to see a list of your registered applications.

Example Request

GET

https://api.twitter.com/1.1/trends/place.json?id=1

Example Result

[
  {
    "as_of": "2012-08-24T23:25:43Z", 
    "created_at": "2012-08-24T23:24:14Z", 
    "locations": [
      {
        "name": "Worldwide", 
        "woeid": 1
      }
    ], 
    "trends": [
      {
        "events": null, 
        "name": "#GanaPuntosSi", 
        "promoted_content": null, 
        "query": "%23GanaPuntosSi", 
        "url": "http://twitter.com/search/?q=%23GanaPuntosSi"
      }, 
      {
        "events": null, 
        "name": "#WordsThatDescribeMe", 
        "promoted_content": null, 
        "query": "%23WordsThatDescribeMe", 
        "url": "http://twitter.com/search/?q=%23WordsThatDescribeMe"
      }, 
      {
        "events": null, 
        "name": "#10PersonasQueExtra\u00f1oMucho", 
        "promoted_content": null, 
        "query": "%2310PersonasQueExtra%C3%B1oMucho", 
        "url": "http://twitter.com/search/?q=%2310PersonasQueExtra%C3%B1oMucho"
      }, 
      {
        "events": null, 
        "name": "Apple $1.5", 
        "promoted_content": null, 
        "query": "%22Apple%20$1.5%22", 
        "url": "http://twitter.com/search/?q=%22Apple%20$1.5%22"
      }, 
      {
        "events": null, 
        "name": "Zelko", 
        "promoted_content": null, 
        "query": "Zelko", 
        "url": "http://twitter.com/search/?q=Zelko"
      }, 
      {
        "events": null, 
        "name": "LWWY", 
        "promoted_content": null, 
        "query": "LWWY", 
        "url": "http://twitter.com/search/?q=LWWY"
      }, 
      {
        "events": null, 
        "name": "Lance Armstrong", 
        "promoted_content": null, 
        "query": "%22Lance%20Armstrong%22", 
        "url": "http://twitter.com/search/?q=%22Lance%20Armstrong%22"
      }, 
      {
        "events": null, 
        "name": "Gonzo", 
        "promoted_content": null, 
        "query": "Gonzo", 
        "url": "http://twitter.com/search/?q=Gonzo"
      }, 
      {
        "events": null, 
        "name": "Premium Rush", 
        "promoted_content": null, 
        "query": "%22Premium%20Rush%22", 
        "url": "http://twitter.com/search/?q=%22Premium%20Rush%22"
      }, 
      {
        "events": null, 
        "name": "Sweet Dreams", 
        "promoted_content": null, 
        "query": "%22Sweet%20Dreams%22", 
        "url": "http://twitter.com/search/?q=%22Sweet%20Dreams%22"
      }
    ]
  }
]