Disqus

Retrieve forum details, posts, categories, and threads from Disqus.

Overview

Disqus is a commenting platform that lets websites embed discussion forums. This tool provides read-only access to the Disqus API v3.0, supporting retrieval of forum details, listing posts (comments), categories, and threads for a given forum. List operations support cursor-based pagination with returnAll/limit patterns.

Category: Communication
Tool Name: disqus
Version: 1

Appearance: Icon: lucide-MessageCircle | Color: #2E9FFF

Node Type

Action — processes input items and produces output

Input / Output

Direction	Port(s)
Input	Input
Output	Output, Error

Credentials

This tool requires Disqus API credentials. See the Credentials Guide for setup instructions.

Resources

Resource	Value
Forum	forum

Operations

Operation	Value	Description
Get	get	Return forum details
Get All Categories	getCategories	Return a list of categories within a forum
Get All Threads	getThreads	Return a list of threads within a forum
Get All Posts	getPosts	Return a list of posts within a forum

Parameters

Forum: Get

Parameter	Type	Required	Default	Description
Forum Name	string	Yes	—	The short name (aka ID) of the forum to get. Supports expressions.
Additional Fields	collection	No	{}	Extra data to request alongside the forum record.
— Attach	multiOptions	No	[]	Additional data to attach to the response.
				Options: counters, followsForum, forumCanDisableAds, forumDaysAlive, forumFeatures, forumForumCategory, forumIntegration, forumNewPolicy, forumPermissions
— Related	multiOptions	No	[]	Relations to include with your response.
				Options: author

Forum: Get All Posts

Parameter	Type	Required	Default	Description
Forum Name	string	Yes	—	The short name (aka ID) of the forum to get posts from. Supports expressions.
Return All	boolean	No	false	Whether to return all results or only up to a given limit.
Limit	number	No	100	Max number of results to return. (shown when Return All is false)
Additional Fields	collection	No	{}	Filtering, ordering and expansion options for the post list.
— Filters	multiOptions	No	[]	Filter posts by specific criteria.
				Options: Has_Bad_Word, Has_Link, Has_Low_Rep_Author, Has_Media, Is_Anonymous, Is_At_Flag_Limit, Is_Flagged, Is_Toxic, Modified_By_Rule, No_Issue, Shadow_Banned
— Include	multiOptions	No	[]	Post states to include in the response.
				Options: approved
— Order	options	No	asc	Sort order for results.
				Options: asc, desc
— Query	string	No	—	Search query string to filter posts.
— Related	multiOptions	No	[]	Relations to include with the response.
				Options: thread
— Since	dateTime	No	—	Unix timestamp (or ISO datetime standard) to filter posts from.

Forum: Get All Categories

Parameter	Type	Required	Default	Description
Forum Name	string	Yes	—	The short name (aka ID) of the forum to get categories from. Supports expressions.
Return All	boolean	No	false	Whether to return all results or only up to a given limit.
Limit	number	No	100	Max number of results to return. (shown when Return All is false)
Additional Fields	collection	No	{}	Ordering options for the category list.
— Order	options	No	asc	Sort order for results.
				Options: asc, desc

Forum: Get All Threads

Parameter	Type	Required	Default	Description
Forum Name	string	Yes	—	The short name (aka ID) of the forum to get threads from. Supports expressions.
Return All	boolean	No	false	Whether to return all results or only up to a given limit.
Limit	number	No	100	Max number of results to return. (shown when Return All is false)
Additional Fields	collection	No	{}	Filtering, ordering and expansion options for the thread list.
— Related	multiOptions	No	[]	Relations to include with the response.
				Options: author, forum
— Include	multiOptions	No	[]	Thread states to include in the response.
				Options: closed, open, killed
— Order	options	No	asc	Sort order for results.
				Options: asc, desc
— Since	dateTime	No	—	Unix timestamp (or ISO datetime standard) to filter threads from.
— Thread	string	No	—	Look up a thread by ID. You may pass the “ident” query type with forum, or the “link” query type to filter by URL. Requires “forum” if you do not have the Pro API Access addon.

All Operations

Parameter	Type	Required	Default	Description
Max Concurrency	number	No	10	Maximum number of items to process concurrently.

Output Data

The Disqus record is merged into the item JSON — the incoming fields pass through and binary data is forwarded.

Operation	Output
get	One item carrying the forum record — its short name, creation date, settings and, when requested via Attach, the extra blocks such as counters
getPosts	One item per post (comment), with the comment body, author, timestamps and moderation state
getCategories	One item per category defined on the forum
getThreads	One item per thread (the discussion attached to a page), with its title, link, identifiers and counts

When a list comes back empty, the input item passes straight through unchanged so the branch is not lost. With Return All on, every page is followed to the end; with it off, results stop at Limit.

Reference a field downstream by expression, e.g. {{ $json.id }}.

Usage Examples

• Get details for a Disqus forum
• List all comments (posts) in a Disqus forum
• Retrieve categories from a Disqus forum
• List threads in a Disqus forum with date filtering

Example Configuration

Get a forum’s details:

{
  "type": "disqus",
  "parameters": {
    "resource": "forum",
    "operation": "get",
    "id": "your-forum-id"
  }
}

Get a forum’s details with extra blocks attached:

{
  "type": "disqus",
  "parameters": {
    "resource": "forum",
    "operation": "get",
    "id": "my-forum-shortname",
    "additionalFields": {
      "attach": ["forumDaysAlive", "forumCanDisableAds"],
      "related": ["author"]
    }
  }
}

Walk every post in a forum, filtered to items that need moderation attention:

{
  "type": "disqus",
  "parameters": {
    "resource": "forum",
    "operation": "getPosts",
    "id": "my-forum-shortname",
    "returnAll": true,
    "additionalFields": {
      "filters": ["Has_Bad_Word", "Is_Flagged"],
      "include": ["approved"],
      "order": "desc",
      "query": "search term",
      "related": ["thread"],
      "since": "2024-01-01T00:00:00Z"
    }
  }
}

Get the 50 most recent posts since a date:

{
  "type": "disqus",
  "parameters": {
    "resource": "forum",
    "operation": "getPosts",
    "id": "my-forum-shortname",
    "returnAll": false,
    "limit": 50,
    "additionalFields": {
      "order": "desc",
      "since": "2024-01-01T00:00:00Z"
    }
  }
}

List every category in a forum:

{
  "type": "disqus",
  "parameters": {
    "resource": "forum",
    "operation": "getCategories",
    "id": "my-forum-shortname",
    "returnAll": true,
    "additionalFields": {
      "order": "asc"
    }
  }
}

List the 10 first categories only:

{
  "type": "disqus",
  "parameters": {
    "resource": "forum",
    "operation": "getCategories",
    "id": "my-forum-shortname",
    "returnAll": false,
    "limit": 10
  }
}

Walk every thread, expanded with its author and forum:

{
  "type": "disqus",
  "parameters": {
    "resource": "forum",
    "operation": "getThreads",
    "id": "my-forum-shortname",
    "returnAll": true,
    "additionalFields": {
      "related": ["author", "forum"],
      "include": ["closed", "open"],
      "order": "desc",
      "since": "2024-01-01T00:00:00Z",
      "thread": "specific-thread-id"
    }
  }
}

Get the 25 most recent threads:

{
  "type": "disqus",
  "parameters": {
    "resource": "forum",
    "operation": "getThreads",
    "id": "my-forum-shortname",
    "returnAll": false,
    "limit": 25,
    "additionalFields": {
      "order": "desc"
    }
  }
}

Error Handling

Mode	Behavior
stop	Halts workflow on first error
continue	Skips failed items, passes successful ones through
errorPort	Routes failed items to Error output port

Tips

Query Disqus forums for details, posts, categories, and threads via the Disqus API.

Notes

• This node is read-only. It retrieves data from Disqus; it does not post, edit or moderate comments.
• Forum Name is the short name, not the site’s display title — the value that appears as disqus_shortname in the embed snippet.
• Return All follows the cursor. Leave it off and set Limit (maximum 100 per operation) when you only need a page.
• Multi-select fields accept several values. Filters, Include, Related and Attach are arrays — pass every value you want in one list.
• Since accepts a Unix timestamp or an ISO datetime, and narrows posts and threads to the ones created after that moment.
• Thread lookups may need the Pro API Access addon when you query by identifier or link without also naming the forum.