Disqus API

Social / OAuth Advanced HTTPS

68 C

Metadata Score Metadata estimate · not endpoint-tested

Visit Official Site Compare Alternatives

Overview

The Disqus API gives developers access to Disqus commenting data, including posts, threads, forums, and user information. You can read public comment threads or perform authenticated actions like creating and moderating comments. OAuth 2.0 is used for actions that require user permissions, while public read operations can use just an API key.

Beginner Tip

For read-only access to public forums, you only need an API key with no full OAuth flow required. Create a Disqus application at disqus.com/api/applications/ to get your public key and start reading data right away.

Available Data

The kind of data this API exposes, based on its documentation. We could not call the endpoint to confirm the exact field names.

Use case: Integrate communicate with disqus data data into web and mobile applications

Disqus data via REST API

Example Response

Illustrative shape only — we were not able to call this endpoint (it requires credentials or exposes no public sample URL), so the fields below show the kind of data this API returns rather than a recorded response.

JSON Response · Illustrative

{
  "status": "success",
  "data": {
    "result": "Data from Disqus",
    "description": "Communicate with Disqus data",
    "timestamp": "2025-01-15T10:00:00Z"
  }
}

Field Reference

code Response code where 0 means success and any other value indicates an error.

response Array of result objects (threads, posts, etc.) returned by the query.

id Unique identifier for the thread or post within Disqus.

title Title of the discussion thread as it appears in the Disqus widget.

posts Total number of approved comments in the thread.

author Object containing the author username, display name, and avatar URL.

Implementation Example

Calls a real endpoint of this API. Replace any placeholder credentials with your own key.

Request

const url = "https://disqus.com/api/3.0/forums/listThreads.json?forum=YOUR_FORUM_SHORTNAME&api_key=YOUR_API_KEY";
// Replace headers or query params with the values required by this API.
const response = await fetch(url, {
  headers: {
  "Authorization": "Bearer YOUR_API_KEY"
  }
});
if (!response.ok) throw new Error(`Request failed: ${response.status}`);
const data = await response.json();
console.log(data);

What Can You Build?

Note: These code examples are AI-generated and unverified. Always refer to the official API documentation for accurate usage.

Common Errors & Troubleshooting

Generated guidance based on this API's documentation, not observed by us. Treat it as a starting point and check against the provider's own error reference.

Invalid API key The api_key parameter is missing or does not match a registered Disqus application.

✓ Create or verify your application at disqus.com/api/applications/ and copy the public key exactly.

403 You are not authorized to perform this action You are trying to perform a write or moderation action without a valid OAuth token.

✓ Complete the OAuth 2.0 authorization flow to obtain an access token, then pass it as the access_token parameter.

Rate limit exceeded You have made more than 1,000 API calls per hour, which is the default limit.

✓ Cache responses locally and reduce the polling frequency. Apply for a higher rate limit if your use case requires it.

Metadata Score Breakdown

Estimated from metadata — endpoint not independently tested

This score is estimated from observable metadata — HTTPS support, authentication model, declared CORS, and documentation reachability — because the API requires authentication or exposes no publicly testable endpoint. The five-signal breakdown is only shown for live-tested APIs.

Metadata estimate · endpoint not independently tested

How is this scored? →