API Documentation

users/listPosts

Returns a list of posts made by the user.

URL

https://disqus.com/api/3.0/users/listPosts.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

  • 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

  • user

    Defaults to null

    Looks up a user by ID
    You may look up a user by username using the 'username' query type.

  • filters allows multiple

    Defaults to []

    Valid values are:
    1: Is_Anonymous
    2: Has_Link
    3: Has_Low_Rep_Author
    4: Has_Bad_Word
    5: Is_Flagged
    6: No_Issue
    7: Is_Toxic
    8: Modified_By_Rule
    9: Shadow_Banned
    10: Has_Media
    11: Is_At_Flag_Limit
    12: Shadow_Banned_Global
    13: Is_New_User_Needs_Approval
    14: Is_Sexual
    15: Is_Hate
    16: Is_Bullying
    17: Is_Violence
    18: Is_Promotion

  • 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

List posts made by the authenticated user.

{ "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/", "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":{ "username":"disqus_api", "about":"", "name":"disqus_api", "url":"", "isFollowing":false, "isFollowedBy":false, "profileUrl":"http://disqus.com/disqus_api/", "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 user=1

{ "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/", "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":{ "username":"disqus_api", "about":"", "name":"disqus_api", "url":"", "isFollowing":false, "isFollowedBy":false, "profileUrl":"http://disqus.com/disqus_api/", "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 } ] }