List topics for a category

CategoriesTopics

List and filter topics for a specific category. Optionally apply some filtering/sorting to find topics matching specific criteria inside this category

GET

/categories/{id}/topics

Parameters

Path Parameters

id*

ID of the category to fetch topics for

Type

string

Required

Query Parameters

publicIds[]

A list of public ids

Type

string

Example"1""2"

tags

A comma-separated list of public tags

Type

string

Example"announcement,official"

moderatorTags

A comma-separated list of moderator tags

Type

string

Example"urgent,trending"

moderationLabels

A comma-separated list of moderation labels

Type

string

Example"checkup,handled"

createdAt

A date range to filter topics based on creation date

lastActivityAt

A date range to filter topics based on last activity

sort

Defines the field to sort the results on. The sort order will be descending. By default the results are ordered by recent activity from most recent to least recent

Type

string

Valid values

"lastActivityAt""createdAt""likes""voteCount""replyCount"

Default

"lastActivityAt"

page

Selects the page to retrieve on paginated responses. Used in combination with the pageSize parameter to paginate over results

Type

integer

Default

1

Minimum

1

pageSize

Limits the number of items returned in a single paginated response. Used in combination with the page parameter to paginate over results

Type

integer

Default

25

Maximum

100

Minimum

1

Responses

Successful response

Content-Type

application/json

{

  

"result": [

  

  

{

  

  

  

"contentType": "conversation",

  

  

  

"id": "1",

  

  

  

"publicId": "5",

  

  

  

"title": "Some conversation title",

  

  

  

"content": "This is the content of a conversation",

  

  

  

"featuredImage": "",

  

  

  

"publicLabel": "",

  

  

  

"categoryId": "6",

  

  

  

"categoryName": "News",

  

  

  

"tags": [

  

  

  

  

"announcement",

  

  

  

  

"first topic"

  

  

  

],

  

  

  

"moderatorTags": [

  

  

  

  

"urgent",

  

  

  

  

"trending"

  

  

  

],

  

  

  

"moderationLabel": "checkup",

  

  

  

"replyCount": 34,

  

  

  

"likes": 124,

  

  

  

"votes": 124,

  

  

  

"voteSet": [

  

  

  

  

"124",

  

  

  

  

"345"

  

  

  

],

  

  

  

"trashed": false,

  

  

  

"sticky": true,

  

  

  

"bestAnswer": true,

  

  

  

"author": {

  

  

  

  

"id": "7",

  

  

  

  

"username": "awesome_user",

  

  

  

  

"avatar": "http://example.com/avatar123.jpg"

  

  

  

},

  

  

  

"lastContributor": {

  

  

  

  

"id": "7",

  

  

  

  

"username": "awesome_user",

  

  

  

  

"avatar": "http://example.com/avatar123.jpg"

  

  

  

},

  

  

  

"createdAt": "2017-04-10T15:29:06+00:00",

  

  

  

"lastActivityAt": "2017-08-10T16:45:54+00:00",

  

  

  

"status": "published",

  

  

  

"productAreas": [

  

  

  

  

"community",

  

  

  

  

"embeddable"

  

  

  

]

  

  

}

  

]

}

Samples