Dog API

{
  "service_type": "platform",
  "base_url": "https://dogapi.dog",
  "auth_method": "none",
  "auth_config": {},
  "endpoints": [
    {
      "path": "/api/v2/breeds",
      "method": "GET",
      "description": "List breeds with pagination and filter",
      "parameters": ["page[number]", "page[size]", "filter[has_images]"]
    },
    {
      "path": "/api/v2/breeds/{id}",
      "method": "GET",
      "description": "Get a single breed by ID"
    },
    {
      "path": "/api/v2/breeds/{id}/image",
      "method": "GET",
      "description": "Get a breed image with optional size and random",
      "parameters": ["size", "random"]
    },
    {
      "path": "/api/v2/breeds/image",
      "method": "GET",
      "description": "Get a random breed image with optional size",
      "parameters": ["size"]
    },
    {
      "path": "/api/v2/facts",
      "method": "GET",
      "description": "List facts with limit",
      "parameters": ["limit"]
    },
    {
      "path": "/api/v2/groups",
      "method": "GET",
      "description": "List groups with pagination",
      "parameters": ["page[number]", "page[size]"]
    },
    {
      "path": "/api/v2/groups/{id}",
      "method": "GET",
      "description": "Get a single group by ID"
    },
    {
      "path": "/api/v1/facts",
      "method": "GET",
      "description": "List facts (v1, deprecated) with number, limit, raw",
      "parameters": ["number", "limit", "raw"]
    }
  ],
  "pricing_model": {
    "type": "free",
    "details": {
      "no_api_key_required": true,
      "no_signup": true,
      "usage_limits": "300 requests per minute per IP"
    }
  },
  "rate_limits": {
    "requests_per_minute": 300,
    "scope": "per IP"
  },
  "capabilities": [
    "breed data retrieval with pagination and filtering",
    "breed images serving (redirect to files)",
    "facts about dogs",
    "breed groups taxonomy",
    "JSON:API format for v2",
    "OpenAPI specification (Swagger) for both v1 and v2",
    "No authentication required",
    "Free and open source (MIT license)",
    "Attribution and license handling for images",
    "Web browsing interface with breed and group pages"
  ],
  "raw_analysis": "Dog API (https://dogapi.dog) is a free, publicly accessible JSON API providing dog-related data: 283 breeds, 9 breed groups, 483 facts, and 2,355 images. It was launched as a Show HN project, indicating a developer-focused initiative. The API is fully open with no authentication or API keys, and rate-limited at 300 requests per minute per IP. It offers two versions: v2 (recommended, JSON:API compliant) and v1 (deprecated, custom format). The documentation is clear, including OpenAPI specs (Swagger) for machine-readable definitions. The service is mature enough to have versioning, deprecation policies, and terms of use. The source code is MIT-licensed on GitHub, promoting transparency and extensibility. Primary capabilities include retrieving breed lists, individual breeds, breed images (with options for size and random), dog facts, and breed groups. Images are served as redirects to maintain licensing and attribution. This platform is ideal for developers building dog-related applications, educational projects, or for anyone needing structured canine data without cost or signup. Potential limitations include the lack of advanced search (only filtering by has_images), absence of authentication for user-specific features, and the rate limit which may be restrictive for high-traffic applications. Overall, it is a niche but well-designed and reliable API for dog data."
}

3/3 tests passed

```json
{
  "overall": 82,
  "dimensions": {
    "token_efficiency": 9.0,
    "first_try_success": 9.5,
    "response_parseability": 9.0,
    "error_clarity": 7.0,
    "doc_quality": 7.5,
    "auth_simplicity": 10.0,
    "latency": 6.0,
    "consistency": 8.5
  },
  "pricing_normalized": {
    "type": "free",
    "signup_required": false,
    "api_key_required": false,
    "rate_limit": "300 requests per minute per IP",
    "open_source": true
  },
  "issues": [
    "Main website response latency at 1037ms is slightly above the 1s threshold for snappy interactions",
    "Rate limit of 300 req/min may be restrictive for high-volume agent workflows",
    "No error handling documentation or explicit error response format noted in analysis",
    "v1 vs v2 API duality could cause confusion for simple use cases"
  ],
  "recommendations": [
    "For agents, always target the v2 JSON:API endpoint to get structured data",
    "Cache breed lists locally to avoid hitting rate limits during repeated lookups",
    "Use pagination and filtering parameters to minimize response payloads",
    "Refer to OpenAPI spec at /api-docs for endpoint definitions rather than trial-and-error"
  ]
}
```