Disqus

{
  "service_type": "platform",
  "base_url": "https://disqus.com/api/",
  "auth_method": "oauth2",
  "auth_config": {
    "authorization_url": "https://disqus.com/api/oauth/2.0/authorize/",
    "token_url": "https://disqus.com/api/oauth/2.0/access_token/",
    "scopes": ["read", "write", "admin", "moderate"],
    "notes": "Requires API key and secret. Public API also supports key-based auth."
  },
  "endpoints": [
    {
      "path": "/oauth/2.0/authorize/",
      "method": "GET",
      "description": "OAuth2 authorization endpoint for user consent"
    },
    {
      "path": "/oauth/2.0/access_token/",
      "method": "POST",
      "description": "Exchange authorization code for access token"
    },
    {
      "path": "/api/3.0/forums/list.json",
      "method": "GET",
      "description": "List forums accessible to user"
    },
    {
      "path": "/api/3.0/forums/details.json",
      "method": "GET",
      "description": "Get forum details"
    },
    {
      "path": "/api/3.0/forums/create.json",
      "method": "POST",
      "description": "Create a new forum"
    },
    {
      "path": "/api/3.0/threads/list.json",
      "method": "GET",
      "description": "List threads in a forum"
    },
    {
      "path": "/api/3.0/threads/details.json",
      "method": "GET",
      "description": "Get thread details"
    },
    {
      "path": "/api/3.0/posts/list.json",
      "method": "GET",
      "description": "List posts in a thread or forum"
    },
    {
      "path": "/api/3.0/posts/create.json",
      "method": "POST",
      "description": "Create a post (comment)"
    },
    {
      "path": "/api/3.0/posts/details.json",
      "method": "GET",
      "description": "Get post details"
    },
    {
      "path": "/api/3.0/posts/update.json",
      "method": "POST",
      "description": "Update a post"
    },
    {
      "path": "/api/3.0/posts/remove.json",
      "method": "POST",
      "description": "Remove a post"
    },
    {
      "path": "/api/3.0/users/details.json",
      "method": "GET",
      "description": "Get user details"
    }
  ],
  "pricing_model": {
    "type": "freemium",
    "details": {
      "free_tier": "Basic features with full API access, rate limited",
      "paid_tiers": "Pro and Business plans for advanced moderation, analytics, customization, and higher rate limits"
    }
  },
  "rate_limits": {
    "free": "1000 API requests per hour per API key (approximately 0.28 req/sec) - subject to change",
    "paid": "Higher limits, depending on plan",
    "notes": "Specific limits vary by plan; check official docs"
  },
  "capabilities": [
    "Comment hosting and moderation",
    "Forum and community management",
    "Thread management",
    "Post creation, reading, updating, deletion",
    "User profile retrieval",
    "OAuth2 authentication for user-based operations",
    "SSO integration for external sites",
    "Spam filtering and moderation tools",
    "Analytics (via platform UI)",
    "Rich text and media embedding in comments",
    "Voting and reactions",
    "Notifications and email digests",
    "Import/export of comments",
    "Embeddable comment widget"
  ],
  "raw_analysis": "Disqus is a mature, widely-adopted third-party commenting platform used by millions of websites and publishers (including news sites, blogs, and forums). It allows site owners to embed a comment system without building their own, offering features like threaded discussions, moderation, spam filtering, social login integration, and analytics. The platform is built on a REST-like JSON API (version 3.0) with OAuth2 authentication for user-specific actions and a simple API key for public read-only data. Disqus provides comprehensive documentation at disqus.com/api/docs, with endpoints for forums, threads, posts, and users. The platform is particularly suited for content-heavy sites that need community engagement; it is also used internally by developers who want to integrate comment functionality into their applications. Disqus is free for basic use, but offers paid tiers (Pro, Business) that remove ads, provide advanced moderation, and increase rate limits. The API is stable, well-documented, and has a large community of developers. Integrations exist for major CMS platforms like WordPress, Drupal, and Joomla, as well as JavaScript widgets. However, as with any third-party service, there are concerns about data ownership and performance for high-traffic sites. Overall, Disqus is a robust, mature platform with a solid API, making it a good choice for adding social discussion to web properties."
}

1/3 tests passed

```json
{
  "overall": 58,
  "dimensions": {
    "token_efficiency": 6.0,
    "first_try_success": 4.0,
    "response_parseability": 7.0,
    "error_clarity": 6.0,
    "doc_quality": 7.0,
    "auth_simplicity": 5.0,
    "latency": 8.5,
    "consistency": 7.0
  },
  "pricing_normalized": {
    "free_tier": "Full API access with rate limits, suitable for small projects",
    "paid_tiers": "Pro and Business plans for advanced moderation and higher limits",
    "value_ratio": "Good for comment hosting but tied to Disqus ecosystem"
  },
  "issues": [
    "No llms.txt or robots.txt for agent discovery",
    "OAuth2 flow adds complexity for user-based operations",
    "Free tier rate limits may be restrictive for high-volume use",
    "Embeddable widget not ideal for headless/API-only workflows"
  ],
  "recommendations": [
    "Add llms.txt with API docs and quick-start examples",
    "Provide machine-readable API schemas (OpenAPI) in docs",
    "Simplify auth with API key for read-only/public operations",
    "Publish rate limits and error codes explicitly for agent handling"
  ]
}
```