Disqus
- Jay Krall
- Kaylin Linke
Source Vitals
Source Attributes | Description |
|---|---|
Data Collection Method | real-time firehose |
Geographic Coverage | global comments from thousands of top news sites |
Key Use Cases | understanding public attitudes about news events and issues |
Delivery Methods | Full stream; filtered stream; select content via News and Blogs search APIs |
Data Dictionary
Posts
Field Name | Field Description | Data example | Data Type |
|---|---|---|---|
author.date_joined | Date the author joined Disqus | 2013-06-13T23:07:43 | string |
author.display_name | Author display name | The Gentle Grizzly |
|
author.num_followers | Commenter's follower count | 35 | int |
author.num_following | Commenter's following count | 3 | int |
author.num_likes_received | Author's total number of likes/upvotes | 50521 | int |
author.num_posts | Total number of posts by the author | 25332 | int |
author.username | Author username | celebrate_homogeneity | string |
author_id | Author ID | ayfk23 | string |
author_url | Profile URL for the comment author | string | |
date | Time of message in ISO 8601 format in US Eastern Daylight time | 2013-11-27T18:09:51 | string |
forum_id | Public Forum ID | 5gat | string |
id | Internal ID | 4k1nvi | string |
message | Message content | I'm still confused as to exactly how, when and why helping those less fortunate became a bad thing. | string |
message_type | Type of message. Options: Post, Vote, ThreadVote | Post | string |
minted | Time that message was processed by server in ISO 8601 format in UTC | 2018-03-21T10:41:46UTC | string |
parent_post_author_id | Author ID of Parent Post | j1mtx | string |
parent_post_id | ID of Parent Post | 4kut2t | string |
post_link | URL of the post | http://www.cnn.com/2013/11/27/opinion/begala-food-stamps-thanksgiving/index.html#comment-1141605534 | string |
public_author_id | Public author ID | 62299211 | int |
public_forum_id | Public Forum ID | 1703446 | int |
public_id | Public ID | 2526857809 | int |
public_parent_post_author_id | Author ID of Parent Post | 32360366 | int |
public_parent_post_id | ID of Parent Post | 1315847909 | int |
public_thread_id | Public Thread ID | 1315847909 | int |
thread_date | Timestamp of the start of the comment's thread. | 2013-11-27T16:31:50 | string |
thread_id | Thread ID | 3gxliv | string |
thread_link | URL of the thread | http://www.cnn.com/2013/11/27/opinion/begala-food-stamps-thanksgiving/index.html#comment-1141605534 | string |
type | Current state of post (options: approved, flagged) | approved | string |
version | Socialgist platform version | socialgist:1 | string |
Votes
Field Name | Field Description | Data example | Data Type |
|---|---|---|---|
date | Time of message in ISO 8601 format in US Eastern Daylight time | 2012-02-16T17:51:35 | string |
forum_id | Public Forum ID | yzhx | string |
id | ID for the comment to which the vote was applied | 6pomoqgybn3y | string |
message_type | Message type, "vote-up" or "vote-down" | Vote | int |
minted | Time that message was processed by server in ISO 8601 format in UTC | 2018-03-21T10:41:46UTC | string |
post_id | ID of post | m6tj78 | string |
post_link | URL of the voted comment | http://www.miamiherald.com/2012/02/15/2643222/luxury-movie-theaters-coming-to.html#comment-546856189 | string |
public_forum_id | Public forum ID assigned by Disqus | 1703446 | int |
public_id | Public ID | 2528469709 | int |
public_recipient_id | Author ID for the voted comment | 2478468708 | int |
public_thread_id | Public thread ID | 13158475909 | int |
public_voter_id | Voter ID | 2698547108 | int |
recipient_id | Different format of author ID for the voted comment | 58s8qh | string |
thread_id | Thread ID | yqp0a1 | int |
thread_link | URL of the voted comment | http://www.miamiherald.com/2012/02/15/2643222/luxury-movie-theaters-coming-to.html#comment-546856189 | int |
version | Socialgist platform version | socialgist:1 | string |
vote | vote count | 1 | int |
voter_id | Voter ID | mh0gr | int |
ThreadVotes
Field Name | Field Description | Socialgist data example | Data Type |
|---|---|---|---|
forum_id | Forum ID | zwpzx | string |
public_thread_id | Public thread ID | 1.31E+09 | int |
thread_id | Thread ID | c2x6mwi | string |
thread_link | Thread link | string | |
thread_date | Timestamp of the parent article of the comment | 2018-03-20T16:06:21 | string |
forum_id | Forum ID | nwnk | string |
date | Time of message in ISO 8601 format in US Eastern Daylight time | 2018-03-21T06:41:46 | string |
message_type | Message type, "vote-up" only (Disqus users cannot downvote at the thread level, only at the comment level) | ThreadVote | string |
minted | Time that message was processed by server in ISO 8601 format in UTC | 2018-03-21T10:41:47UTC | string |
version | Socialgist platform version | socialgist:1 | string |
id | ID for the comment to which the vote was applied | cx63wb | string |
public_id | Public comment ID | 2175984808 | int |
public_voter_id | Public voter ID | 0 | int |
vote | Vote count | 1 | int |
voter_id | Voter ID |
| int |
Example Messages
Post (aka comment)
{
"message_body": {
"public_parent_post_id": "0",
"thread_link": "https://order-order.com/2018/03/21/mogg-13-mps-write-may-declaring-transition-deal-completely-unacceptable/",
"public_id": "3816786744",
"parent_post_author_id": "-1",
"author": {
"username": "Katabasis",
"display_name": "Katabasis",
"public_author_id": "3524389",
"num_followers": "18",
"num_likes_received": "85059",
"author_url": "https://disqus.com/by/Katabasis/",
"num_posts": "13615",
"author_id": "8cq7f",
"num_following": "4",
"date_joined": "2010-06-30T17:25:06"
},
"post_link": "https://order-order.com/2018/03/21/mogg-13-mps-write-may-declaring-transition-deal-completely-unacceptable/#comment-3816786744",
"type": "approved",
"public_thread_id": "6567303987",
"changed": {},
"forum_id": "awkle",
"public_parent_post_author_id": "0",
"thread_date": "2018-03-21T04:18:06",
"parent_post_id": "-1",
"date": "2018-03-21T06:41:43",
"public_forum_id": "3306534",
"message": "May made her intentions perfectly clear at the Florence Speech - \"the UK does not seek competitive advantage\".\n\nStill scraping my jaw off the floor over that one. Would have been bad enough if it had just been a rank and file MP, but the \"Conservative\" Prime Minister of the UK?.",
"thread_id": "c2b25ej",
"id": "aj5z042"
},
"version": "socialgist:1",
"message_type": "Post",
"minted": "2018-03-21T10:41:47UTC"
} |
Vote
{
"message_body": {
"thread_link": "http://www.rapupdate.de/du-maroc-veroeffentlicht-blog-aus-der-jva-butzbach-video/",
"public_voter_id": "269106733",
"public_id": "1425111295614525549",
"voter_id": "5vmsca",
"thread_id": "c2b5gan",
"post_link": "http://www.rapupdate.de/du-maroc-veroeffentlicht-blog-aus-der-jva-butzbach-video/#comment-1425111295614525549",
"public_thread_id": "6567491720",
"changed": {},
"forum_id": "ah2zj",
"vote": 1,
"post_id": "aj5z07q",
"recipient_id": "58s8qh",
"date": "2018-03-21T06:41:45",
"public_forum_id": "2286675",
"public_post_id": "3816786655",
"id": "6pomoqgybn3y",
"public_recipient_id": "246720217"
},
"version": "socialgist:1",
"message_type": "Vote",
"minted": "2018-03-21T10:41:46UTC"
} |
ThreadVote
{
"message_body": {
"thread_link": "http://resistenciapodcast.com/rp43-feminismo-feminilidade/",
"public_voter_id": "0",
"public_id": "217181038",
"voter_id": "-1",
"thread_id": "c2x6mwi",
"public_thread_id": "6566095830",
"changed": {},
"forum_id": "8amwd",
"thread_date": "2018-03-20T16:06:21",
"vote": 1,
"date": "2018-03-21T06:41:46",
"public_forum_id": "3416192",
"id": "cx63wb"
},
"version": "socialgist:1",
"message_type": "ThreadVote",
"minted": "2018-03-21T10:41:47UTC"
} |