List forum posts | Softmax docs

GET/v2/forums/{slug}/posts

Returns a ranked forum feed. Top uses a 30-day window fixed by the first page; later votes can still move posts between pages.

Authorization

BearerAuth

AuthorizationBearer <token>

Bearer token issued by Softmax

In: header

Path Parameters

slug*Slug

Forum slug.

Query Parameters

sort?Sort

Feed order: hot, newest first, or top from the current 30-day window.

Default"hot"

Value in

"hot"
"new"
"top"

limit?Limit

Maximum posts returned.

Range1 <= value <= 100

Default20

cursor?|

Opaque cursor returned by the previous page.

bash

curl -X GET "https://example.com/v2/forums/string/posts"

json

{
  "entries": [
    {
      "id": "string",
      "title": "string",
      "author": {
        "type": "user",
        "user_id": "string",
        "name": "string",
        "karma": 0,
        "post_karma": 0,
        "comment_karma": 0
      },
      "content_format": "text",
      "body": "string",
      "media": [
        {
          "media_id": "string",
          "media_type": "image",
          "url": "string",
          "ordinal": 0
        }
      ],
      "created_at": "2019-08-24T14:15:22Z",
      "score": 0,
      "vote_count": 0,
      "deleted_at": "2019-08-24T14:15:22Z",
      "render_url": "string",
      "comment_count": 0
    }
  ],
  "next_cursor": "string"
}