Available Public API Data

Unlimited API access is currently available as an add-on for users with a Pro level subscription.

If you would like to subscribe to Pro, you can do so in your subscription settings at Admin > Settings > Subscription and Billing.

Please visit the Disqus Data Platform to learn more about the web's largest first party data set.

There are several data objects available through the Disqus API that contain related information about each. Most API calls will return one or more of these objects in a single response. Actual data might vary depending on the endpoint and authentication level, so see our API documentation to find out which individual calls return what.
Tip: Many API calls allow you to add/expand objects by using a 'related' argument so you can get all necessary data in a single response.
 

Topics

Topics are like categories, which contains different forums and threads.
Key Type Description
id string The unique ID of the topic.
name string The display name of the topic.

Forum (website)

A forum contains all of a website's comments, threads and settings. This is the highest level which data is grouped on the Disqus network.
Key Type Description
name string The name entered in the Disqus admin settings
founder string Disqus ID number of the primary moderator of the site.
settings object Settings booleans associated with the website
url string The given URL entered in the Disqus admin settings
favicon object The permalinked and cached URLs of the site's favicons
language string The two-letter language code that the site has chosen as the default
id string The Disqus shortname of the website

Category

Categories exist for grouping threads within a forum. These are currently only used in conjunction with the API. Read more about categories here.
Key Type Description
isDefault boolean Whether or not this is the default category for the website
title string The chosen title of the category from the Disqus admin settings
order integer The order that the category is listed as
forum string The Disqus shortname that the category belongs to
id string Unique numerical ID of the category across the entire Disqus network

Thread

Threads are core discussions on the Disqus network which are represented by the standard Disqus embed.
Key Type Description
feed string A link to an RSS feed of the latest comments on the thread
reactions integer The number of reactions (tweets) detected for the thread
canModerate boolean Whether the user has the ability to moderate the thread. Will only return true if request is authenticated and if the user is the author of the thread or moderator of the forum.
canPost boolean Whether the user can post comments on the thread. Will return true for unauthenticated requests only if guest commenting is enabled for the forum, and the thread isn't closed.
author string Disqus ID number of the author of the thread. By default this is the primary moderator of the forum. Typically this is expandable using related=author
forum string Disqus shortname of the forum. Typically this is expandable using related=forum
title string The title of the discussion
dislikes integer The number of unique dislikes for a thread (currently unused)
identifiers array The unique identifier values passed by the website to a thread (typically using disqus_identifier). Read more about identifiers.
userScore integer The score that the authenticated user has given to a particular thread. Typically this is just 0 or 1.
createdAt string (Date/Time) The timestamp of the thread when it was created in the Disqus system.
slug string The unique slug associated with the thread. This is auto-generated by Disqus in most cases.
isClosed boolean Whether or not the thread allows new comments or not.
posts integer The number of comments, both parents and replies, within a thread.
userSubscription boolean Whether or not the authenticated user has subscribed to the thread by email.
link string URL of the thread. This must be unique to the forum.
likes integer The number of unique likes on a thread. This is represented in the embed as stars.
message string The content of the article/post that the discussion is about. This is typically empty unless explicitly set by the website.
category string The unique category ID that the thread belongs to.
id string The Disqus ID number for the thread which is unique across the entire network
isDeleted boolean Whether or not the thread has been deleted (killed) by the forum owner

Post (comment)

An individual comment within a thread
Key Type Description
isJuliaFlagged boolean (currently unused) Whether the comment has been system-flagged.
isFlagged boolean Whether or not the comment has been flagged by at least one other user.
forum string The Disqus shortname of the forum which the comment was posted under.
parent integer (nullable) The ID number of the parent comment. Will return null if it's a top-level comment. NOTE: This is changing to a string in the near future. See latest API responses for current status
author object Information about the comment author
media array Links to images that the user attached to their comment.
isDeleted boolean Whether the comment has been deleted or not.
isApproved boolean Whether or not the comment is publicly visible. Unapproved comments are only visible to the comment author and forum moderators.
dislikes integer The number of dislikes (downvotes) a comment has received.
raw_message string The unformatted comment body.
createdAt string (Date/Time) The timestamp of the comment when it was created in the Disqus system.
id string The network-wide unique ID number associated with the comment.
thread string The Disqus thread ID number that the comment belongs to. Typically this is expandable by using related=thread.
numReports integer The number of unique flags that the comment has received from other users.
likes integer The number of unique likes (upvotes) that the comment has received.
isEdited boolean Whether the comment has been edited by the commenter or moderator.
points integer The sum of the likes (upvotes) and the dislikes (downvotes).
message string The comment body with HTML formatting.
isSpam boolean Whether or not the comment has been marked as spam.
isHighlighted boolean Whether or not a thread author or forum moderator has "highlighted" the comment.
userScore integer The score that the authenticated user has given to a particular comment. Typically this is just -1, 0 or 1.

User/Author

A user on Disqus, who can have several relationships to other data types such as other users (following), threads (authorship), forums (moderator), and posts (commenter).
Key Type Description
username string The unique username associated with the account.
numFollowers integer The number of people who follow this user.
isFollowing boolean Whether or not the person making the request is following the user. Will only return true if request is authenticated, and authenticated user has chosen to follow this user.
name string The display name of the user as entered in their account settings.
emailHash string Hashed email address of the user
url string The user's website URL as entered in their account settings.
joinedAt string (Date/Time) The date/time that the user created the account.
rep double Calculated user reputation. Same as reputation
about string The user's bio.
avatar object Permalink and cache image URLs of the user avatar in different sizes.
isFollowedBy boolean Whether or not the user follows the person making the request. Will only return true if request is authenticated, and the user has chosen to follow authenticated user.
connections object Third party social connections made by the user (e.g. Twitter, Facebook, Google).
numPosts integer The number of comments posted by the user.
reputation double Calculated user reputation. Same as rep.
location string Location that user specified in their account settings.
profileUrl string The disqus.com permalink URL to their profile.
numLikesReceived integer The number of upvotes the user has received for their comments.
isPrimary boolean Whether or not the user has registered any forums under this account.
isAnonymous boolean Whether or not the user has a registered account or not
id string The network-wide unique ID of the user. This never changes, even if the person changes their unique username.
numFollowing integer The number of people this user follows.

Did you find this article helpful?