Topics

Get specific posts from a topic

GET

https://discourse.example.com/t/{id}/posts.json

curl -X GET 'https://discourse.example.com/t/string/posts.json' \
  -H 'Api-Key: string' \
  -H 'Api-Username: string' \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "post_ids[]": 0
}'

const body = `{
  "post_ids[]": 0
}`;

const response = await fetch('https://discourse.example.com/t/string/posts.json', {
  method: 'GET',
  headers: {
    'Api-Key': 'string',
    'Api-Username': 'string',
    'Content-Type': 'application/json',
  },
  body,
});

const data = await response.text();

import requests

body = '''{
  "post_ids[]": 0
}'''

response = requests.get(
    'https://discourse.example.com/t/string/posts.json',
    data=body.encode('utf-8'),
    headers={
        'Api-Key': 'string',
        'Api-Username': 'string',
        'Content-Type': 'application/json',
    },
)
print(response.text)

Request Body

{
  "post_ids[]": 0
}

200

{
  "post_stream": {
    "posts": [
      {
        "id": 0,
        "name": "string",
        "username": "string",
        "avatar_template": "string",
        "created_at": "string",
        "cooked": "string",
        "post_number": 0,
        "post_type": 0,
        "updated_at": "string",
        "reply_count": 0,
        "reply_to_post_number": "string",
        "quote_count": 0,
        "incoming_link_count": 0,
        "reads": 0,
        "readers_count": 0,
        "score": 0,
        "yours": true,
        "topic_id": 0,
        "topic_slug": "string",
        "display_username": "string",
        "primary_group_name": "string",
        "flair_name": "string",
        "flair_url": "string",
        "flair_bg_color": "string",
        "flair_color": "string",
        "version": 0,
        "can_edit": true,
        "can_delete": true,
        "can_recover": true,
        "can_wiki": true,
        "read": true,
        "user_title": "string",
        "actions_summary": [
          {
            "id": 0,
            "can_act": true
          }
        ],
        "moderator": true,
        "admin": true,
        "staff": true,
        "user_id": 0,
        "hidden": true,
        "trust_level": 0,
        "deleted_at": "string",
        "user_deleted": true,
        "edit_reason": "string",
        "can_view_edit_history": true,
        "wiki": true,
        "reviewable_id": 0,
        "reviewable_score_count": 0,
        "reviewable_score_pending_count": 0
      }
    ]
  },
  "id": 0
}

Body

application/json

post_ids[]integerrequired

Parameters

Api-Keystringrequiredheader

Api-Usernamestringrequiredheader

idstringrequiredpath

Response

200OKobject

specific posts

Response fields application/json

post_streamobject

Show child attributes

postsArray<object>

Show child attributes

idinteger

namestring | null

usernamestring

avatar_templatestring

created_atstring

cookedstring

post_numberinteger

post_typeinteger

updated_atstring

reply_countinteger

reply_to_post_numberstring | null

quote_countinteger

incoming_link_countinteger

readsinteger

readers_countinteger

scorenumber

yoursboolean

topic_idinteger

topic_slugstring

display_usernamestring | null

primary_group_namestring | null

flair_namestring | null

flair_urlstring | null

flair_bg_colorstring | null

flair_colorstring | null

versioninteger

can_editboolean

can_deleteboolean

can_recoverboolean

can_wikiboolean

readboolean

user_titlestring | null

actions_summaryArray<object>

Show child attributes

idinteger

can_actboolean

moderatorboolean

adminboolean

staffboolean

user_idinteger

hiddenboolean

trust_levelinteger

deleted_atstring | null

user_deletedboolean

edit_reasonstring | null

can_view_edit_historyboolean

wikiboolean

reviewable_idinteger

reviewable_score_countinteger

reviewable_score_pending_countinteger

idinteger

Docs by Sourcey