Disqus Forums API

The Forums API from Disqus — 10 operation(s) for forums.

GitHub OpenAPI

Operations 10

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

GET /forums/details.json Get a forum's details · Get forum details #
Ask an LLM
“What are the details of a forum, like its name and URL?”
“Can I look up one forum by its shortname?”
Tell an agent
Show the details of forum {forum}.
Get the name and URL of forum {forum}.
POST /forums/create.json Create a new forum · Create a new forum #
Ask an LLM
“How do I create a new forum on Disqus?”
“Can I set a forum's name and default category when creating it?”
Tell an agent
Create a new forum with my API key.
Set up a fresh forum using the API key.
POST /forums/update.json Update a forum's details · Update forum details #
Ask an LLM
“Can I rename an existing forum or change its settings?”
“What's the way to edit a forum's details?”
Tell an agent
Update the details of my forum with the API key.
Change the settings of an existing forum.
GET /forums/listThreads.json List threads in a forum · List threads within a forum #
Ask an LLM
“What threads are posted in a forum?”
“Can I list only the threads of one forum?”
Tell an agent
List the threads in forum {forum}.
Show every thread posted in {forum}.
GET /forums/listPosts.json List posts in a forum · List posts within a forum #
Ask an LLM
“Which posts have been made in a forum?”
“Can I get all posts from a single forum?”
Tell an agent
List the posts in forum {forum}.
Show every comment posted in {forum}.
GET /forums/listModerators.json List a forum's moderators · List moderators on a forum #
Ask an LLM
“Who are the moderators of a forum?”
“Can I see which users moderate a forum?”
Tell an agent
List the moderators of forum {forum}.
Show who moderates {forum}.
POST /forums/addModerator.json Add a moderator to a forum · Add a moderator to a forum #
Ask an LLM
“How do I make someone a moderator of a forum?”
“Can I add a user as a moderator on a forum?”
Tell an agent
Add a moderator to my forum with the API key.
Make a user a moderator of a forum.
POST /forums/removeModerator.json Remove a moderator from a forum · Remove a moderator from a forum #
Ask an LLM
“Can I take away someone's moderator status on a forum?”
“What happens when a forum moderator is removed?”
Tell an agent destructive · confirm first
Remove a moderator from my forum with the API key.
Take a user off the moderator list of a forum.
POST /forums/follow.json Follow a forum · Follow a forum #
Ask an LLM
“How do I follow a forum so I get notifications?”
“Can I subscribe to a forum's new posts?”
Tell an agent
Follow a forum with my API key.
Subscribe to a forum so I get updates.
POST /forums/unfollow.json Unfollow a forum · Unfollow a forum #
Ask an LLM
“Can I stop following a forum?”
“What do I do to unsubscribe from a forum?”
Tell an agent destructive · confirm first
Unfollow a forum with my API key.
Stop following a forum so I stop getting notifications.

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/disqus:disqus-forums-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. By signing up you are subscribing to the APIs.io and API Evangelist newsletters — you can unsubscribe from any issue. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

disqus-forums-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Disqus Public Forums API
  description: REST API for Disqus comments, threads, forums, users, and categories. Read and write operations are authenticated using an API key and secret, with OAuth 2.0 access tokens for user-context operations. All endpoints are served under https://disqus.com/api/3.0/.
  version: '3.0'
servers:
- url: https://disqus.com/api/3.0
  description: Disqus API v3.0
security:
- apiKey: []
- oauth2: []
tags:
- name: Forums
paths:
  /forums/details.json:
    get:
      tags:
      - Forums
      summary: Get forum details
      operationId: forumsDetails
      parameters:
      - name: forum
        in: query
        required: true
        schema:
          type: string
      - $ref: '#/components/parameters/ApiKey'
      responses:
        '200':
          description: Forum details
  /forums/create.json:
    post:
      tags:
      - Forums
      summary: Create a new forum
      operationId: forumsCreate
      parameters:
      - $ref: '#/components/parameters/ApiKey'
      responses:
        '200':
          description: Created
  /forums/update.json:
    post:
      tags:
      - Forums
      summary: Update forum details
      operationId: forumsUpdate
      parameters:
      - $ref: '#/components/parameters/ApiKey'
      responses:
        '200':
          description: Updated
  /forums/listThreads.json:
    get:
      tags:
      - Forums
      summary: List threads within a forum
      operationId: forumsListThreads
      parameters:
      - name: forum
        in: query
        required: true
        schema:
          type: string
      - $ref: '#/components/parameters/ApiKey'
      responses:
        '200':
          description: Threads
  /forums/listPosts.json:
    get:
      tags:
      - Forums
      summary: List posts within a forum
      operationId: forumsListPosts
      parameters:
      - name: forum
        in: query
        required: true
        schema:
          type: string
      - $ref: '#/components/parameters/ApiKey'
      responses:
        '200':
          description: Posts
  /forums/listModerators.json:
    get:
      tags:
      - Forums
      summary: List moderators on a forum
      operationId: forumsListModerators
      parameters:
      - name: forum
        in: query
        required: true
        schema:
          type: string
      - $ref: '#/components/parameters/ApiKey'
      responses:
        '200':
          description: Moderators
  /forums/addModerator.json:
    post:
      tags:
      - Forums
      summary: Add a moderator to a forum
      operationId: forumsAddModerator
      parameters:
      - $ref: '#/components/parameters/ApiKey'
      responses:
        '200':
          description: Added
  /forums/removeModerator.json:
    post:
      tags:
      - Forums
      summary: Remove a moderator from a forum
      operationId: forumsRemoveModerator
      parameters:
      - $ref: '#/components/parameters/ApiKey'
      responses:
        '200':
          description: Removed
  /forums/follow.json:
    post:
      tags:
      - Forums
      summary: Follow a forum
      operationId: forumsFollow
      parameters:
      - $ref: '#/components/parameters/ApiKey'
      responses:
        '200':
          description: Followed
  /forums/unfollow.json:
    post:
      tags:
      - Forums
      summary: Unfollow a forum
      operationId: forumsUnfollow
      parameters:
      - $ref: '#/components/parameters/ApiKey'
      responses:
        '200':
          description: Unfollowed
components:
  parameters:
    ApiKey:
      name: api_key
      in: query
      schema:
        type: string
  securitySchemes:
    apiKey:
      type: apiKey
      in: query
      name: api_key
    oauth2:
      type: oauth2
      flows:
        authorizationCode:
          authorizationUrl: https://disqus.com/api/oauth/2.0/authorize/
          tokenUrl: https://disqus.com/api/oauth/2.0/access_token/
          scopes:
            read: Read forums, threads, posts
            write: Create posts and threads
            admin: Forum administration