Disqus API Reference Developer Documentation

Build custom integrations with our REST API for commenting, moderation, analytics, and more.

Get Started with API →

API Capabilities

  • Retrieve comments, threads, and user data programmatically
  • Real-time webhooks for comment events and moderation actions
  • Custom moderation actions via REST endpoints
  • Analytics endpoints for comment volume and engagement stats

Try Our API Sandbox

Test endpoints instantly with our interactive playground:

GET https://api.disqus.com/api/threads/list.json?api_key=YOUR_KEY...

Quick Start Guide

Authentication

Use API key authentication with your Developer API key:

curl -H "Api-Key: YOUR_PUBLIC_KEY" -H "Api-Secret: YOUR_SECRET_KEY" ...

Core Endpoints

List Comments

GET /api/comments/list.json

{ "thread": 12345, "limit": 20, "since": "2025-01-01" }

Create Comment

POST /api/comments/create.json

{ "thread": 12345, "message": "Hello community!", "author": 67890 }

Official SDKs

npm

Node.js and browser-based applications

npm install disqus-sdk-js
Pip

Python applications and scripts

pip install disqus-python
Composer

PHP applications and integrations

composer require disqus/sdk-php

Full API Reference

Comments

Create, retrieve, and moderate comments

Threads

Manage comment threads and conversations

Analytics

Access engagement and moderation statistics

Ready to Build?

Our API makes it easy to create custom comment moderation tools, analytics dashboards, and more.

View API Tutorials →