• Home /
  • Sources /
  • Disqus /
  • Data Format
  • Data Format


    The following table describes the root-level object for Disqus activities in Gnip’s Activity Streams format.

    actor

    An object referring to the author of the comment or person who voted.

    Note: Disqus provides anonymized author data through its firehose.  The actor element contains a distinct hashed value provided by Disqus, which corresponds to a specific Disqus user, and is common to all activities generated by that user.
    Show Sub-field Details

    Property Description
    id A unique IRI for the Disqus user.

    "id":"tag:gnip.disqus.com:2012:account/dc0pk"
                                                
    objectType "person"

    "objectType":"person"
                                               
    preferredUsername The author's username. The username corresponds to the user’s login. It is not always identical to the user’s display name and may be machine generated in some cases.

    "preferredUsername": "npr-cbc5dd63549e706b27ae09214ec5c0db"
                                               
    disqusId The user's public ID. This ID will match with data pulled from the public Disqus API documented at http://disqus.com/api/docs/.

    "disqusId": "62299211"
                                               
    "actor":
    {
       "id":"tag:gnip.disqus.com:2012:account/dc0pk",
       "disqusId": "62299211",
       "preferredUsername": "npr-cbc5dd63549e706b27ae09214ec5c0db",
       "objectType":"person"
    }
                            

    verb

    For comments this can be "post", "update" or "delete". For votes we have created the extensions "vote-up", "vote-down" or "unvote". For a description of AS verbs see http://activitystrea.ms/head/activity-schema.html#verbs.

    "verb":"update"
                			

    postedTime

    The publish time of the activity.

    Note: Disqus provides its site administrators with an optional setting to allow users to specify a user-generated postedTime for either the thread of comments or an individual comment. These user-generated postedTimes can be far back in history (e.g. 1940's). As a result, though data is delivered in realtime as it is posted to Disqus, it can have a postedTime that is in the past.

    Disqus also allows site administrators to upload comments data from other platforms the web site may have utilized at some point in the past. This data gets delivered through the firehose as it is uploaded, but will have postedTimes that reflect when it was originally posted on the other commenting platform.

    "postedTime":"2012-02-16T16:49:35+00:00"
                			

    id

    A unique IRI for the Disqus activity.

    "id":"tag:gnip.disqus.com:2012:comment/m6nd0p/update"
                			

    body

    The text of the comment.

    "body":"I'm all about keeping more of our hard earned money (fair tax / flat tax), but taking money away from SS today just means less money tomorrow (when you retire)."
                			

    disqusType

    The current approval state of a comment. Only comments have these, not votes. Possible values include: "unapproved", "approved", "flagged", "killed" and "spam".

    "disqusType":"approved"
                			

    disqusTypePrev

    The previous approval state of a comment. Only comments have these, not votes.

    "disqusTypePrev":"approved"
                			

    inReplyTo

    A comment object representing the comment being replied to. Unlike the Twitter AS, this does not contain a permalink to the object that was replied to. However, it does contain a unique id for the object that as well as the unique id for the author of the comment. See the comment object for more details.

    Show Sub-field Details

    Property Description
    id A unique IRI for the comment.

    "id":"tag:gnip.disqus.com:2012:comment/m6nev1"
                                                
    disqusId The parent comment ID. This ID will match with data pulled from the public Disqus API documented at http://disqus.com/api/docs/.

    "disqusId": "1306157453"
                                                
    objectType "comment"

    See http://activitystrea.ms/head/activity-schema.html#comment for more detailed information.
    "objectType":"comment"
                                               
    link

    A permalink to the comment on the page

    "link":"http://www.foxnews.com/politics/2012/02/15/house-senate-deal-reached-on-payroll-tax-cut/#comment-441004169"
                                               
    author Optional. An object used for vote activities and inReplyTo, where the author of the comment being acted on is not the actor.

    This will contain an objectType field ("person" See http://activitystrea.ms/head/activity-schema.html#person for more detailed information), an id field (A unique IRI for the author of the comment), and a disqusId field (The parent user ID). The disqusId will match with data pulled from the public Disqus API documented at http://disqus.com/api/docs/.
    "author":
    {
          "id":"tag:gnip.disqus.com:2012:account/e5j5l",
          "disqusId": "32360366"
    }
                                               
    "inReplyTo":
    {
        "id":"tag:gnip.disqus.com:2012:comment/m6nev1",
        "disqusId": "1306157453",
        "link":"http://www.foxnews.com/politics/2012/02/15/house-senate-deal-reached-on-payroll-tax-cut/#comment-441004169",
        "author":{
          "id":"tag:gnip.disqus.com:2012:account/e5j5l",
          "disqusId": "32360366"
        },
        "objectType":"comment"
    }
                            

    object

    An object representing the comment or vote being made.
    Show Sub-field Details

    Property Description
    id A unique IRI for the comment, or the page where the comment or vote occurred.

    "id":"tag:gnip.disqus.com:2012:comment/m6nd0p"
                                                
    disqusId The comment ID. This ID will match with data pulled from the public Disqus API documented at http://disqus.com/api/docs/.

    "disqusId": "1306216359"
                                                
    objectType "comment" or "article"

    "objectType":"comment"
                                               
    link A permalink to the comment on the page, or to the page where the comment or vote occurred.

    "link":"http://www.foxnews.com/politics/2012/02/15/house-senate-deal-reached-on-payroll-tax-cut/#comment-441004169"
                                               
    website An object representing the website that's page contains the comment or vote. This will contain a unique id for the website.

    "website":
    {
          "id":"tag:gnip.disqus.com:2012:forum/nwnk"
    }
                                               
    author Optional. An object used for vote activities, where the author of the comment being acted on is not the actor.

    This will contain an objectType field ("person" See http://activitystrea.ms/head/activity-schema.html#person for more detailed information), and an id field (A unique IRI for the author of the comment).
    "author":
    {
          "id":"tag:gnip.disqus.com:2012:account/mh0gr",
          "objectType":"person"
    }
                                               

    "object":
    {
         "id":"tag:gnip.disqus.com:2012:comment/m6tj78",
         "author":
         {
               "id":"tag:gnip.disqus.com:2012:account/mh0gr",
               "objectType":"person"
         },
         "link":"http://www.miamiherald.com/2012/02/15/2643222/luxury-movie-theaters-coming-to.html#comment-546856189",
         "objectType":"comment",
         "disqusId": "1306216359"
    }
                            

    target

    An object representing the page the comment was posted to or where vote was made.
    Show Sub-field Details

    Property Description
    id A unique IRI for the page where the comment or vote occurred.

    "id":"tag:gnip.disqus.com:2012:thread/ynaqwr"
                                                
    disqusId The thread ID. This ID will match with data pulled from the public Disqus API documented at http://disqus.com/api/docs/.

    "disqusId": "2517638098"
                                                
    website An object representing the website that's page contains the comment or vote. This will contain a unique id for the website, as well as a "disqusId" field, which represents the forum ID The disqusId will match with data pulled from the public Disqus API documented at http://disqus.com/api/docs/.

    "website":
    {
         "id":"tag:gnip.disqus.com:2012:forum/yjmx",
         "disqusId": "1703446"
    }
                                               
    link A link to the article / comment thread.

    "link":"http://www.foxnews.com/politics/2012/02/15/house-senate-deal-reached-on-payroll-tax-cut/"
                                               
    postedTime The creation time of the article's comment thread.

    "postedTime":"2012-02-16T04:33:23+00:00"
                                               
    objectType "article"

    "objectType":"article"
                                               
    "target":
    {
         "id":"tag:gnip.disqus.com:2012:thread/ynaqwr",
         "website":
         {
              "id":"tag:gnip.disqus.com:2012:forum/yjmx",
              "disqusId": "1703446"
         },
         "link":"http://www.foxnews.com/politics/2012/02/15/house-senate-deal-reached-on-payroll-tax-cut/",
         "disqusId": "2517638098",
         "postedTime":"2012-02-16T04:33:23+00:00",
         "objectType":"article"
    }
                            

    Sample Payloads