Wallhaven

{
  "service_type": "platform",
  "base_url": "https://wallhaven.cc",
  "auth_method": "api_key",
  "auth_config": {
    "api_key": "optional, required for some endpoints"
  },
  "endpoints": [
    {
      "path": "/api/v1/search?q={query}&categories={categories}&purity={purity}&sorting={sorting}&order={order}&page={page}",
      "method": "GET",
      "description": "Search for wallpapers with optional filters"
    },
    {
      "path": "/api/v1/w/{id}",
      "method": "GET",
      "description": "Get wallpaper details by ID"
    },
    {
      "path": "/api/v1/w/{id}/tags",
      "method": "GET",
      "description": "Get tags for a wallpaper"
    },
    {
      "path": "/api/v1/collections/{username}/{collection_id}",
      "method": "GET",
      "description": "Get wallpapers from a collection"
    },
    {
      "path": "/api/v1/users/{username}/collections",
      "method": "GET",
      "description": "List user's collections"
    },
    {
      "path": "/api/v1/users/{username}/favorites",
      "method": "GET",
      "description": "Get user's favorites"
    },
    {
      "path": "/api/v1/users/{username}/settings",
      "method": "GET",
      "description": "Get user settings (requires auth)"
    }
  ],
  "pricing_model": {
    "type": "freemium",
    "details": {
      "free": "Access to all wallpapers and API with rate limits",
      "premium": "Faster API, no rate limits, and other perks"
    }
  },
  "rate_limits": {
    "free": "30 requests per minute",
    "premium": "Unlimited, 1 request per second sustained"
  },
  "capabilities": [
    "Search wallpapers",
    "Get wallpaper details and metadata",
    "Tag browsing",
    "User collections and favorites",
    "Search by resolution, category, purity",
    "Sorting and filtering",
    "SFW/NSFW content filtering"
  ],
  "raw_analysis": "Wallhaven is a mature wallpaper hosting platform with a large community and an extensive database of high-quality wallpapers. It provides a public REST API for programmatic access to search and retrieve wallpapers, tags, and user collections. The site has been operating since 2015 and includes features like user collections, favorites, and categorization. The API is free to use with optional API key for higher rate limits. It supports categories (general, anime, people) and purity levels (SFW, sketchy, NSFW). Integration is straightforward via HTTP GET requests. The platform is suitable for personal projects, desktop apps, or scripts that need wallpaper search functionality. The API is documented on their help page, and endpoints return JSON. Authentication is via API key as a query parameter or header, though many public endpoints work without it. Rate limits apply to unauthorized requests."
}

3/3 tests passed

```json
{
  "overall": 72,
  "dimensions": {
    "token_efficiency": 8.0,
    "first_try_success": 6.0,
    "response_parseability": 7.0,
    "error_clarity": 5.0,
    "doc_quality": 6.0,
    "auth_simplicity": 7.0,
    "latency": 9.0,
    "consistency": 8.0
  },
  "pricing_normalized": {
    "free_tier": "Full access with rate limits",
    "premium_tier": "Unlimited API access",
    "cost_estimate": "Unknown — requires manual visit for pricing details"
  },
  "issues": [
    "Missing /llms.txt — no machine-readable LLM documentation found",
    "Robots.txt has content signal requirements that may complicate scraping or API use",
    "No clear API documentation in the capabilities summary — requires additional research",
    "Auth simplicity unclear — likely requires manual signup, not SSO or magic link"
  ],
  "recommendations": [
    "Add a dedicated /llms.txt file with structured API docs and examples",
    "Clarify API rate limits and authentication flow in the platform description",
    "Provide a direct getting-started guide in the capabilities data",
    "Add explicit error codes and response schemas to improve parseability"
  ]
}
```