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

1/connect/topics/trending

1/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.

Requires Chatter

No

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)

1{"currentPageUrl" : "/services/data/v37.0/connect/topics/trending?maxResults=5",
2"nextPageUrl" : null,
3"topics" : [
4   {
5      "createdDate": "2013-01-01T20:43:31.000Z",
6      "id" : "0TOD0000000090qOAA",
7      "description" : "Application Programming Interface",
8      "talkingAbout" : 527,
9      "name" : "API",
10      "url": "/services/data/v37.0/connect/topics/0TOD0000000090qOAA"
11   },
12   {
13      "createdDate": "2012-11-14T05:24:23.000Z",
14      "id" : "0TOD000000006RxOAI",
15      "description" : "The cloud computing event of the year.",
16      "talkingAbout" : 424,
17      "name" : "Dreamforce",
18      "url": "/services/data/v37.0/connect/topics/0TOD000000006RxOAI"
19   },
20   {
21      "createdDate": "2013-02-25T10:47:51.000Z",
22      "id" : "0TOD0000000090rOAA",
23      "description" : "All things related to mobile.",
24      "talkingAbout" : 87,
25      "name" : "Mobile",
26      "url": "/services/data/v37.0/connect/topics/0TOD0000000090rOAA"
27   }
28]}

Example response body (version 24.0–27.0)

1{"topics" : [
2   {
3      "name" : "#API"
4   },
5   {
6      "name" : "#Dreamforce"
7   },
8   {
9      "name" : "#Mobile"
10   }
11]}