Posts

Retrieve a single post

GET

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

This endpoint can be used to get the number of likes on a post using the actions_summary property in the response. actions_summary responses with the id of 2 signify a like. If there are no actions_summary items with the id of 2, that means there are 0 likes. Other ids likely refer to various different flag types.

curl -X GET 'https://discourse.example.com/posts/string.json'

const response = await fetch('https://discourse.example.com/posts/string.json', {
  method: 'GET',
});

const data = await response.text();

import requests

response = requests.get('https://discourse.example.com/posts/string.json')
print(response.text)

200

{
  "id": 0,
  "username": "string",
  "avatar_template": "string",
  "created_at": "string",
  "cooked": "string",
  "post_number": 0,
  "post_type": 0,
  "posts_count": 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",
  "primary_group_name": "string",
  "flair_name": "string",
  "flair_url": "string",
  "flair_bg_color": "string",
  "flair_color": "string",
  "flair_group_id": 0,
  "version": 0,
  "can_edit": true,
  "can_delete": true,
  "can_recover": true,
  "can_see_hidden_post": true,
  "can_wiki": true,
  "user_title": "string",
  "bookmarked": true,
  "raw": "string",
  "actions_summary": [
    {
      "id": 0,
      "count": 0,
      "acted": true,
      "can_undo": true,
      "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,
  "post_url": "string",
  "mentioned_users": [],
  "name": "string",
  "display_username": "string"
}

Parameters

idstringrequiredpath

Response

200OKany

single reviewable post

Response fields application/json

idintegerrequired

usernamestringrequired

avatar_templatestringrequired

created_atstringrequired

cookedstringrequired

post_numberintegerrequired

post_typeintegerrequired

posts_countintegerrequired

updated_atstringrequired

reply_countintegerrequired

reply_to_post_numberstring | nullrequired

quote_countintegerrequired

incoming_link_countintegerrequired

readsintegerrequired

readers_countintegerrequired

scorenumberrequired

yoursbooleanrequired

topic_idintegerrequired

topic_slugstringrequired

primary_group_namestring | nullrequired

flair_namestring | nullrequired

flair_urlstring | nullrequired

flair_bg_colorstring | nullrequired

flair_colorstring | nullrequired

flair_group_idinteger | null

versionintegerrequired

can_editbooleanrequired

can_deletebooleanrequired

can_recoverbooleanrequired

can_see_hidden_postboolean

can_wikibooleanrequired

user_titlestring | nullrequired

bookmarkedbooleanrequired

rawstringrequired

actions_summaryArray<object>required

Show child attributes

idintegerrequired

2: like, 3, 4, 6, 7, 8: flag

countinteger

actedboolean

can_undoboolean

can_actboolean

moderatorbooleanrequired

adminbooleanrequired

staffbooleanrequired

user_idintegerrequired

hiddenbooleanrequired

trust_levelintegerrequired

deleted_atstring | nullrequired

user_deletedbooleanrequired

edit_reasonstring | nullrequired

can_view_edit_historybooleanrequired

wikibooleanrequired

reviewable_idinteger | nullrequired

reviewable_score_countintegerrequired

reviewable_score_pending_countintegerrequired

post_urlstringrequired

mentioned_usersArray<any>

namestring | null

display_usernamestring | null

Docs by Sourcey