Trending Topics

The more frequently people add a specific topic to their posts and comments and comment on or like posts with the same topic over a short period of time, the more likely it is to become a trending topic. For example, if your coworkers are attending the upcoming Dreamforce conference and have started discussing it in Chatter, you may see a trending topic for Dreamforce. A trending topic is not solely based on popularity and usually relates to a one-time or infrequent event that has a spike in activity, such as a conference or a project deadline.

Resource

/connect/topics/trending

/connect/communities/communityId/topics/trending

Available since version

29.0

In versions 24.0–28.0, use /chatter/topics/trending and /connect/communities/communityId/chatter/topics/trending.

HTTP methods

GET or HEAD

Request parameters

Parameter Name	Values	Description
maxResults	Integer	Maximum number of trending topics that get returned. The default is 5. Value must be greater than 0 and less than 100.

Response body

Topic Collection

Example response body (version 28.0 and later)

{"currentPageUrl" : "/services/data/v64.0/connect/topics/trending?maxResults=5",
"nextPageUrl" : null,
"topics" : [
   {
      "createdDate": "2013-01-01T20:43:31.000Z",
      "id" : "0TOD0000000090qOAA",
      "description" : "Application Programming Interface",
      "talkingAbout" : 527,
      "name" : "API",
      "url": "/services/data/v64.0/connect/topics/0TOD0000000090qOAA"
   },
   {
      "createdDate": "2012-11-14T05:24:23.000Z",
      "id" : "0TOD000000006RxOAI",
      "description" : "The cloud computing event of the year.",
      "talkingAbout" : 424,
      "name" : "Dreamforce",
      "url": "/services/data/v64.0/connect/topics/0TOD000000006RxOAI"
   },
   {
      "createdDate": "2013-02-25T10:47:51.000Z",
      "id" : "0TOD0000000090rOAA",
      "description" : "All things related to mobile.",
      "talkingAbout" : 87,
      "name" : "Mobile",
      "url": "/services/data/v64.0/connect/topics/0TOD0000000090rOAA"
   }
]}

Example response body (version 24.0–27.0)

{"topics" : [
   {
      "name" : "#API"
   },
   {
      "name" : "#Dreamforce"
   },
   {
      "name" : "#Mobile"
   }
]}