Trending Topics

Get the top five trending topics for the org.

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.

In API versions earlier than 28.0, topics began with a hashtag (#).

Note

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.

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/v61.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/v61.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/v61.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/v61.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]}

Connect REST API Developer Guide

Trending Topics