GET trends/place
get-trends-place

GET trends/place

Returns the top 50 trending topics for a specific id, if trending information is available for it.

Note: The id parameter for this endpoint is the "where on earth identifier" or WOEID, which is a legacy identifier created by Yahoo and has been deprecated. Twitter API v1.1 still uses the numeric value to identify town and country trend locations. Reference our legacy blog post, or archived data

Example WOEID locations include: Worldwide: 1 UK: 23424975 Brazil: 23424768 Germany: 23424829 Mexico: 23424900 Canada: 23424775 United States: 23424977 New York: 2459115

To identify other ids, please use the GET trends/available endpoint.

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.

The most up to date info available is returned on request. The created_at field will show when the oldest trend started trending. The as_of field contains the timestamp when the list of trends was created.

The tweet_volume for the last 24 hours is also returned for many trends if this is available.

Resource URL

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

Resource Information

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

Parameters

Name Required Description Default Value Example
id required The numeric value that represents the location from where to return trending information for from. Formerly linked to the Yahoo! Where On Earth ID Global information is available by using 1 as the WOEID . 1
exclude optional Setting this equal to hashtags will remove all hashtags from the trends list.

Example Request

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

Example Response

[
  {
    "trends": [
      {
        "name": "#GiftAGamer",
        "url": "http://twitter.com/search?q=%23GiftAGamer",
        "promoted_content": null,
        "query": "%23GiftAGamer",
        "tweet_volume": null
      },
      {
        "name": "#AskCuppyAnything",
        "url": "http://twitter.com/search?q=%23AskCuppyAnything",
        "promoted_content": null,
        "query": "%23AskCuppyAnything",
        "tweet_volume": 14504
      },
      {
        "name": "#givethanks",
        "url": "http://twitter.com/search?q=%23givethanks",
        "promoted_content": null,
        "query": "%23givethanks",
        "tweet_volume": null
      },
      {
        "name": "Carrefour",
        "url": "http://twitter.com/search?q=Carrefour",
        "promoted_content": null,
        "query": "Carrefour",
        "tweet_volume": 438616
      },
      {
        "name": "#StreamLifeGoesOn",
        "url": "http://twitter.com/search?q=%23StreamLifeGoesOn",
        "promoted_content": null,
        "query": "%23StreamLifeGoesOn",
        "tweet_volume": 179026
      },
      {
        "name": "STREAM BE PARTY",
        "url": "http://twitter.com/search?q=%22STREAM+BE+PARTY%22",
        "promoted_content": null,
        "query": "%22STREAM+BE+PARTY%22",
        "tweet_volume": 71404
      },
      {
        "name": "#TransDayOfRemembrance",
        "url": "http://twitter.com/search?q=%23TransDayOfRemembrance",
        "promoted_content": null,
        "query": "%23TransDayOfRemembrance",
        "tweet_volume": 45852
      },
      {
        "name": "Mourão",
        "url": "http://twitter.com/search?q=Mour%C3%A3o",
        "promoted_content": null,
        "query": "Mour%C3%A3o",
        "tweet_volume": 12614
      },
      {
        "name": "Taysom Hill",
        "url": "http://twitter.com/search?q=%22Taysom+Hill%22",
        "promoted_content": null,
        "query": "%22Taysom+Hill%22",
        "tweet_volume": 20311
      },
      {
        "name": "Geraldo",
        "url": "http://twitter.com/search?q=Geraldo",
        "promoted_content": null,
        "query": "Geraldo",
        "tweet_volume": 30166
      }
    ],
    "as_of": "2020-11-20T19:37:52Z",
    "created_at": "2020-11-19T14:15:43Z",
    "locations": [
      {
        "name": "Worldwide",
        "woeid": 1
      }
    ]
  }
]