<!-- BusyBot node reference — https://busybot.net/tools/disqus/ -->

> Node: Disqus (`disqus`) · Action · v1
> Category: Communication · Credentials: Disqus API (`disqusApi`)
> Updated: 2026-08-16

# 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](https://busybot.net/credentials/disqus-api/) 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:

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

Get a forum's details with extra blocks attached:

```json
{
  "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:

```json
{
  "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:

```json
{
  "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:

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

List the 10 first categories only:

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

Walk every thread, expanded with its author and forum:

```json
{
  "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:

```json
{
  "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.