Dev.to

{
  "service_type": "platform",
  "base_url": "https://dev.to/api",
  "auth_method": "api_key",
  "auth_config": {
    "api_key": {
      "header": "api-key"
    }
  },
  "endpoints": [
    {
      "name": "List Articles",
      "path": "/articles",
      "method": "GET",
      "description": "Get published articles, can be filtered by tag, username, state, etc."
    },
    {
      "name": "Create Article",
      "path": "/articles",
      "method": "POST",
      "description": "Create a new article (requires authentication)"
    },
    {
      "name": "Update Article",
      "path": "/articles/{id}",
      "method": "PUT",
      "description": "Update an existing article (requires authentication)"
    },
    {
      "name": "Get Article by ID",
      "path": "/articles/{id}",
      "method": "GET",
      "description": "Fetch a single published article by its ID."
    },
    {
      "name": "Get User",
      "path": "/users/{id}",
      "method": "GET",
      "description": "Fetch a public user profile by ID."
    },
    {
      "name": "Get Me",
      "path": "/users/me",
      "method": "GET",
      "description": "Get authenticated user's details (requires authentication)."
    },
    {
      "name": "List Comments",
      "path": "/comments",
      "method": "GET",
      "description": "Get comments, can be filtered by article ID or user ID."
    },
    {
      "name": "List Tags",
      "path": "/tags",
      "method": "GET",
      "description": "Get a list of tags with usage counts."
    },
    {
      "name": "List Podcast Episodes",
      "path": "/podcast_episodes",
      "method": "GET",
      "description": "Get podcast episodes, can be filtered by username."
    },
    {
      "name": "List Followed Tags",
      "path": "/follows/tags",
      "method": "GET",
      "description": "Get tags followed by authenticated user."
    }
  ],
  "pricing_model": {
    "type": "freemium",
    "details": {
      "free": "Public API access with rate limits, no API key required for read-only endpoints.",
      "premium": "No explicit paid tier; authentication via API key (free to obtain) unlocks write operations."
    }
  },
  "rate_limits": {
    "limit": null,
    "window": null,
    "description": "Rate limits not publicly documented. Unofficial limits may apply. Authentication increases limits."
  },
  "capabilities": [
    "Content publishing (create, update, delete articles)",
    "Read articles, comments, tags, podcast episodes",
    "User profile and follower management",
    "Search articles by tag, username, etc.",
    "Community engagement (comments, reactions)",
    "Supports Markdown and rich content",
    "Integrated with Forem communities (including DEV)"
  ],
  "raw_analysis": "Dev.to is a community platform built on Forem, an open-source software for building communities. The API is documented at developers.forem.com and allows developers to programmatically access and manage content. It is designed for developers, content creators, and community managers who want to integrate or automate interactions with Forem-based communities. The platform is mature, with many third-party integrations (e.g., GitHub, Twitter, CMS plugins). The API uses API-key authentication for write operations, while read access is generally available without authentication. Pricing is freemium: the API is free, but there is no paid tier on the platform itself; monetization is via user subscriptions on DEV. Rate limits are not clearly documented, which may be a concern for high-volume usage. The platform is actively developed with a strong ecosystem."
}

1/3 tests passed

```json
{
  "overall": 72,
  "dimensions": {
    "token_efficiency": 7.5,
    "first_try_success": 7.0,
    "response_parseability": 8.5,
    "error_clarity": 6.5,
    "doc_quality": 7.0,
    "auth_simplicity": 8.0,
    "latency": 8.5,
    "consistency": 7.0
  },
  "pricing_normalized": {
    "model": "freemium",
    "free_tier": "Read-only public API access, no API key required",
    "write_operations": "Free API key unlocks write capabilities",
    "paid_tier": "No explicit paid tier mentioned"
  },
  "issues": [
    "No llms.txt to help agents discover API endpoints efficiently",
    "Robots.txt not found (404) - may miss crawl optimization",
    "Write operations require API key setup, adds slight friction",
    "Documentation is Docusaurus-based but lacks explicit limitations/error codes documentation"
  ],
  "recommendations": [
    "Add llms.txt to provide structured API overview for AI agents",
    "Publish robots.txt to clarify crawlable paths",
    "Document common error codes and rate limits explicitly",
    "Provide explicit getting-started example flows in docs"
  ]
}
```