Developers » API methods » Board » board.getTopics
Returns a list of topics on a community's discussion board.
This method can be called by a service token. Only public data is returned.
This method can be called with a user token.
group_idID of the community that owns the discussion board.
positive number, required parameter
topic_idsIDs of topics to be returned (100 maximum). By default, all topics are returned.

If this parameter is set, the order, offset, and count parameters are ignored.
list of comma-separated numbers
orderSort order. Possible values:
  • 1 by date updated in reverse chronological order;
  • 2 by date created in reverse chronological order;
  • -1 by date updated in chronological order;
  • -2 by date created in chronological order.

If no sort order is specified, topics are returned in the order specified by the group administrator. Pinned topics are returned first, regardless of the sorting.
int (number)
offsetOffset needed to return a specific subset of topics.
positive number
countNumber of topics to return.
positive number, default 40, maximum value 100
extended1 to return information about users who created topics or who posted there last;
0 to return no additional fields (by default).
flag, either 1 or 0
preview1 to return the first comment in each topic;
2 to return the last comment in each topic;
0 to return no comments (by default).
int (number)
preview_lengthNumber of characters after which to truncate the previewed comment. To preview the full comment, specify 0.
positive number, default 90
Returns an object containing the following fields:

Results number.
Array of objects describing topics.
Sort type. Possible values:
  • 1 by descending of the last update date;
  • 2 by descending of the creation date;
  • -1 by ascending of the last update date;
  • -2 by ascending of the creation date.
integer, [0,1]
Information whether the current user can create topics in the community. Possible values:
  • 0 can;
  • 1 cannot.
An array of objects describing users. Each of objects contains base fields andsex, photo_50, photo_100, online, type (= profile) fields. (for extended = 1 only).
Global errors can occur while running. See their descriptions on this page.
Version historyShow all
In all methods that return people objects, photo, photo_medium_rec fields were renamed to photo_50, photo_100.
In wall attachment from and copy_owner fields return as user or community object, not array.