List of Topics

List of topics for the organization.

Resource
1/connect/topics
Available since version
29.0

In version 28.0, use /chatter/topics.

HTTP methods
GET or HEAD
Request parameters
Parameter Name Values Description Required or Optional Available Version
exactMatch Boolean Use with the q parameter and specify true to find a topic by its exact, case-insensitive name. Default value is false. Optional 28.0
page Integer An integer greater than 0 specifying a page of topics. The default value is zero. Optional 28.0
pageSize Integer Specifies the number of items per page. Valid values are between 1 and 100. The default value is 25. Optional 28.0
q String A query string to filter the results. The string must contain at least two characters, not including wildcards. Optional 28.0
sort String One of the following values:
  • popularDesc—Sorts topics by popularity with the most popular first. This value is the default.
  • alphaAsc—Sorts topics alphabetically.
Optional 28.0
Response body
Topic Collection
Example for GET
This example requests a list of topics sorted alphabetically:
1/connect/topics?sort=alphaAsc

This is the JSON Topic Collection response body:

1{"currentPageUrl" : "/services/data/v30.0/connect/topics?sort=alphaAsc",
2"nextPageUrl" : "/services/data/v30.0/connect/topics?sort=alphaAsc&page=1",
3"topics" : [
4   {
5      "createdDate": "2013-01-01T20:43:31.000Z",
6      "id" : "0TOD0000000090qOAA",
7      "description" : "Application Programming Interface",
8      "talkingAbout" : 27,
9      "name" : "API",
10      "url": "/services/data/v30.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/v30.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/v30.0/connect/topics/0TOD0000000090rOAA"
27   },
28   {
29      "createdDate": "2012-10-09T12:49:17.000Z",
30      "id" : "0TOD000000007PXOAY",
31      "description" : "Promotion announcements.",
32      "talkingAbout" : 43,
33      "name" : "Promotion",
34      "url": "/services/data/v30.0/connect/topics/0TOD000000007PXOAY"
35   },
36   {
37      "createdDate": "2013-02-13T23:19:32.000Z",
38      "id" : "0TOD000000006RwOAI",
39      "description" : "Workbench provides the user with a graphical interface to work with file systems and launch applications.",
40      "talkingAbout" : 9,
41      "name" : "Workbench",
42      "url": "/services/data/v30.0/connect/topics/0TOD000000006RwOAI"
43   }
44]}