API Documentation

posts/list

Returns a list of posts ordered by the date created.

URL

https://disqus.com/api/3.0/posts/list.json

Accessibility

public key, secret key

Supported request methods

GET

Supported formats

json, jsonp, rss

Requires authentication

no

Rate limited

inherits global rate limit

Arguments

Optional

  • category allows multiple

    Defaults to null

    Looks up a category by ID

  • thread allows multiple

    Defaults to null

    Looks up a thread by ID

  • forum allows multiple

    Defaults to null

    Defaults to all forums you moderate. Use :all to retrieve all forums.

  • since

    Defaults to null

    Unix timestamp (or ISO datetime standard)

  • related allows multiple

    Defaults to []

    You may specify relations to include with your response.
    Choices: forum, thread

  • cursor

    Defaults to null

  • limit

    Defaults to 25

    Maximum value of 100

  • offset

    Defaults to 0

    Deprecated: Please see documentation on cursors

  • query

    Defaults to null

  • include allows multiple

    Defaults to [ "approved" ]

    Choices: unapproved, approved, spam, deleted, flagged, highlighted

  • order

    Defaults to "desc"

    Choices: asc, desc

Example Responses

Expand json

GET forum=bobross

{
  "cursor":{
    "prev":null,
    "hasNext":false,
    "next":"1213061528000000:1:0",
    "hasPrev":false,
    "total":null,
    "id":"1213061528000000:1:0",
    "more":false
  },
  "code":0,
  "response":[
    {
      "isJuliaFlagged":true,
      "isFlagged":false,
      "forum":"bobross",
      "parent":1,
      "author":{
        "username":"disqus_api",
        "about":"",
        "name":"disqus_api",
        "url":"",
        "isFollowing":false,
        "isFollowedBy":false,
        "profileUrl":"http://disqus.com/disqus_api/",
        "emailHash":"67f79ed8e10b74abf07a8dfe101bbab2",
        "avatar":{
          "permalink":"http://disqus.com/api/users/avatars/disqus_api.jpg",
          "cache":"http://mediacdn.disqus.com/1091/images/noavatar92.png"
        },
        "id":"1",
        "isAnonymous":false,
        "email":"example@disqus.com"
      },
      "media":[],
      "isApproved":true,
      "dislikes":0,
      "raw_message":"\"Happy little bush.\"",
      "id":"3",
      "thread":"1",
      "points":0,
      "createdAt":"2008-06-10T01:45:27",
      "isEdited":false,
      "message":"\"Happy little bush.\"",
      "isHighlighted":false,
      "ipAddress":"127.0.0.1",
      "isSpam":false,
      "isDeleted":false,
      "likes":0
    },
    {
      "isJuliaFlagged":true,
      "isFlagged":false,
      "forum":"bobross",
      "parent":null,
      "author":{
        "name":null,
        "url":null,
        "profileUrl":"",
        "emailHash":"575007c5f1370d7cf76cbd79e5a81584",
        "avatar":{
          "permalink":"http://www.gravatar.com/avatar.php?gravatar_id=575007c5f1370d7cf76cbd79e5a81584&size=32&default=http://mediacdn.disqus.com/1091/images/noavatar32.png",
          "cache":"http://www.gravatar.com/avatar.php?gravatar_id=575007c5f1370d7cf76cbd79e5a81584&size=32&default=http://mediacdn.disqus.com/1091/images/noavatar32.png"
        },
        "isAnonymous":true,
        "email":"richard.nixon@example.com"
      },
      "media":[],
      "isApproved":true,
      "dislikes":0,
      "raw_message":"\"Happy little tree limb.\"",
      "id":"2",
      "thread":"1",
      "points":0,
      "createdAt":"2008-06-10T01:45:04",
      "isEdited":false,
      "message":"\"Happy little tree limb.\"",
      "isHighlighted":false,
      "ipAddress":"127.0.0.1",
      "isSpam":false,
      "isDeleted":false,
      "likes":0
    },
    {
      "isJuliaFlagged":true,
      "isFlagged":false,
      "forum":"bobross",
      "parent":null,
      "author":{
        "username":"disqus_api",
        "about":"",
        "name":"disqus_api",
        "url":"",
        "isFollowing":false,
        "isFollowedBy":false,
        "profileUrl":"http://disqus.com/disqus_api/",
        "emailHash":"67f79ed8e10b74abf07a8dfe101bbab2",
        "avatar":{
          "permalink":"http://disqus.com/api/users/avatars/disqus_api.jpg",
          "cache":"http://mediacdn.disqus.com/1091/images/noavatar92.png"
        },
        "id":"1",
        "isAnonymous":false,
        "email":"example@disqus.com"
      },
      "media":[],
      "isApproved":true,
      "dislikes":0,
      "raw_message":"\"We want happy paintings. Happy paintings. If you want sad things, watch the news.\"",
      "id":"1",
      "thread":"1",
      "points":1,
      "createdAt":"2008-06-10T01:32:08",
      "isEdited":false,
      "message":"\"We want happy paintings. Happy paintings. If you want sad things, watch the news.\"",
      "isHighlighted":false,
      "ipAddress":"127.0.0.1",
      "isSpam":false,
      "isDeleted":false,
      "likes":1
    }
  ]
}
Expand json

GET related=thread&forum=bobross

{
  "cursor":{
    "prev":null,
    "hasNext":false,
    "next":"1213061528000000:1:0",
    "hasPrev":false,
    "total":null,
    "id":"1213061528000000:1:0",
    "more":false
  },
  "code":0,
  "response":[
    {
      "isJuliaFlagged":true,
      "isFlagged":false,
      "forum":"bobross",
      "parent":1,
      "author":{
        "username":"disqus_api",
        "about":"",
        "name":"disqus_api",
        "url":"",
        "isFollowing":false,
        "isFollowedBy":false,
        "profileUrl":"http://disqus.com/disqus_api/",
        "emailHash":"67f79ed8e10b74abf07a8dfe101bbab2",
        "avatar":{
          "permalink":"http://disqus.com/api/users/avatars/disqus_api.jpg",
          "cache":"http://mediacdn.disqus.com/1091/images/noavatar92.png"
        },
        "id":"1",
        "isAnonymous":false,
        "email":"example@disqus.com"
      },
      "media":[],
      "isApproved":true,
      "dislikes":0,
      "raw_message":"\"Happy little bush.\"",
      "id":"3",
      "thread":{
        "category":"1",
        "reactions":0,
        "identifiers":[
          "my-identifier"
        ],
        "forum":"bobross",
        "title":"Happy Accidents",
        "dislikes":0,
        "isDeleted":false,
        "author":"1",
        "userScore":0,
        "id":"1",
        "isClosed":false,
        "posts":7,
        "link":null,
        "likes":0,
        "message":"\"If you've painted before you know that we don't make mistakes -- we have happy accidents.\"",
        "ipAddress":"127.0.0.1",
        "slug":"happy_accidents",
        "createdAt":"2008-06-10T01:31:43"
      },
      "points":0,
      "createdAt":"2008-06-10T01:45:27",
      "isEdited":false,
      "message":"\"Happy little bush.\"",
      "isHighlighted":false,
      "ipAddress":"127.0.0.1",
      "isSpam":false,
      "isDeleted":false,
      "likes":0
    },
    {
      "isJuliaFlagged":true,
      "isFlagged":false,
      "forum":"bobross",
      "parent":null,
      "author":{
        "name":null,
        "url":null,
        "profileUrl":"",
        "emailHash":"575007c5f1370d7cf76cbd79e5a81584",
        "avatar":{
          "permalink":"http://www.gravatar.com/avatar.php?gravatar_id=575007c5f1370d7cf76cbd79e5a81584&size=32&default=http://mediacdn.disqus.com/1091/images/noavatar32.png",
          "cache":"http://www.gravatar.com/avatar.php?gravatar_id=575007c5f1370d7cf76cbd79e5a81584&size=32&default=http://mediacdn.disqus.com/1091/images/noavatar32.png"
        },
        "isAnonymous":true,
        "email":"richard.nixon@example.com"
      },
      "media":[],
      "isApproved":true,
      "dislikes":0,
      "raw_message":"\"Happy little tree limb.\"",
      "id":"2",
      "thread":{
        "category":"1",
        "reactions":0,
        "identifiers":[
          "my-identifier"
        ],
        "forum":"bobross",
        "title":"Happy Accidents",
        "dislikes":0,
        "isDeleted":false,
        "author":"1",
        "userScore":0,
        "id":"1",
        "isClosed":false,
        "posts":7,
        "link":null,
        "likes":0,
        "message":"\"If you've painted before you know that we don't make mistakes -- we have happy accidents.\"",
        "ipAddress":"127.0.0.1",
        "slug":"happy_accidents",
        "createdAt":"2008-06-10T01:31:43"
      },
      "points":0,
      "createdAt":"2008-06-10T01:45:04",
      "isEdited":false,
      "message":"\"Happy little tree limb.\"",
      "isHighlighted":false,
      "ipAddress":"127.0.0.1",
      "isSpam":false,
      "isDeleted":false,
      "likes":0
    },
    {
      "isJuliaFlagged":true,
      "isFlagged":false,
      "forum":"bobross",
      "parent":null,
      "author":{
        "username":"disqus_api",
        "about":"",
        "name":"disqus_api",
        "url":"",
        "isFollowing":false,
        "isFollowedBy":false,
        "profileUrl":"http://disqus.com/disqus_api/",
        "emailHash":"67f79ed8e10b74abf07a8dfe101bbab2",
        "avatar":{
          "permalink":"http://disqus.com/api/users/avatars/disqus_api.jpg",
          "cache":"http://mediacdn.disqus.com/1091/images/noavatar92.png"
        },
        "id":"1",
        "isAnonymous":false,
        "email":"example@disqus.com"
      },
      "media":[],
      "isApproved":true,
      "dislikes":0,
      "raw_message":"\"We want happy paintings. Happy paintings. If you want sad things, watch the news.\"",
      "id":"1",
      "thread":{
        "category":"1",
        "reactions":0,
        "identifiers":[
          "my-identifier"
        ],
        "forum":"bobross",
        "title":"Happy Accidents",
        "dislikes":0,
        "isDeleted":false,
        "author":"1",
        "userScore":0,
        "id":"1",
        "isClosed":false,
        "posts":7,
        "link":null,
        "likes":0,
        "message":"\"If you've painted before you know that we don't make mistakes -- we have happy accidents.\"",
        "ipAddress":"127.0.0.1",
        "slug":"happy_accidents",
        "createdAt":"2008-06-10T01:31:43"
      },
      "points":1,
      "createdAt":"2008-06-10T01:32:08",
      "isEdited":false,
      "message":"\"We want happy paintings. Happy paintings. If you want sad things, watch the news.\"",
      "isHighlighted":false,
      "ipAddress":"127.0.0.1",
      "isSpam":false,
      "isDeleted":false,
      "likes":1
    }
  ]
}
Expand rss

GET forum=bobross

<?xml version="1.0" encoding="utf-8"?>
<rss version="2.0" xmlns:content="http://purl.org/rss/1.0/modules/content/" xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:slash="http://purl.org/rss/1.0/modules/slash/">
  <channel>
    <title>
      http://testserver/api/3.0/posts/list.rss?api_secret=sZW65ZZAiOpVIouUUSC25xcFpzthByd0c2sxquZ52zTxd1rQjV6BwHw277RwO33d&amp;forum=bobross
    </title>
    <link>
      http://testserver/api/3.0/posts/list.rss?api_secret=sZW65ZZAiOpVIouUUSC25xcFpzthByd0c2sxquZ52zTxd1rQjV6BwHw277RwO33d&amp;forum=bobross
    </link>
    <description>
      Generated RSS feed from DISQUS API
    </description>
    <pubDate>
      2011-11-02T02:22:54Z
    </pubDate>
    <docs>
      http://disqus.com/api/
    </docs>
    <generator>
      DisqusAPI/3.0
    </generator>
    <item>
      <guid>
        3
      </guid>
      <title>
        Re: Happy Accidents
      </title>
      <link />
      <description>
        "Happy little bush."
      </description>
      <content:encoded>
        <![CDATA["Happy little bush."]]>
      </content:encoded>
      <pubDate>
        2008-06-10T01:45:27Z
      </pubDate>
      <dc:creator>
        disqus_api
      </dc:creator>
    </item>
    <item>
      <guid>
        2
      </guid>
      <title>
        Re: Happy Accidents
      </title>
      <link />
      <description>
        "Happy little tree limb."
      </description>
      <content:encoded>
        <![CDATA["Happy little tree limb."]]>
      </content:encoded>
      <pubDate>
        2008-06-10T01:45:04Z
      </pubDate>
      <dc:creator />
    </item>
    <item>
      <guid>
        1
      </guid>
      <title>
        Re: Happy Accidents
      </title>
      <link />
      <description>
        "We want happy paintings. Happy paintings. If you want sad things, watch the news."
      </description>
      <content:encoded>
        <![CDATA["We want happy paintings. Happy paintings. If you want sad things, watch the news."]]>
      </content:encoded>
      <pubDate>
        2008-06-10T01:32:08Z
      </pubDate>
      <dc:creator>
        disqus_api
      </dc:creator>
    </item>
  </channel>
</rss>