Flickr

{
  "service_type": "platform",
  "base_url": "https://www.flickr.com/services/api",
  "auth_method": "oauth1",
  "auth_config": {
    "oauth_version": "1.0",
    "oauth_flow": "request_token",
    "credentials": [
      "api_key",
      "api_secret",
      "access_token",
      "access_token_secret"
    ],
    "authentication_url": "https://www.flickr.com/services/oauth/request_token",
    "authorization_url": "https://www.flickr.com/services/oauth/authorize",
    "access_token_url": "https://www.flickr.com/services/oauth/access_token"
  },
  "endpoints": [
    {
      "path": "/services/rest",
      "method": "GET",
      "description": "Main API endpoint for Flickr REST methods (e.g., flickr.photos.search, flickr.people.getPublicPhotos). Supports method parameter."
    },
    {
      "path": "/services/upload",
      "method": "POST",
      "description": "Upload a photo to Flickr. Requires authentication."
    },
    {
      "path": "/services/replace",
      "method": "POST",
      "description": "Replace an existing photo on Flickr. Requires authentication."
    },
    {
      "path": "/services/feeds/photos_public.gne",
      "method": "GET",
      "description": "Public feed of recent photos (may be used without authentication)."
    }
  ],
  "pricing_model": {
    "type": "freemium",
    "details": {
      "free_tier": "1TB storage, ads, limited uploads, free account",
      "pro_subscription": "Unlimited storage, ad-free, advanced stats, pricing varies (typically annual), professional features",
      "api_usage": "API access is free for non-commercial use, but commercial use requires approval and may have limits; Flickr reserves rights to rate-limit and requires attribution for API use"
    }
  },
  "rate_limits": {
    "api_requests": "3600 requests per hour per user (authenticated) and per API key for non-authenticated",
    "upload_limits": "Depending on account type; free accounts limited to 1000 photos, Pro accounts have no explicit limit but subject to general terms"
  },
  "capabilities": [
    "photo and video hosting",
    "photo management (albums, collections, tags)",
    "search and discovery (flickr.photos.search)",
    "social features (contacts, groups, favorites, comments)",
    "metadata management (exif, geotags)",
    "photo upload and replace via REST API",
    "feed access (public, group, user feeds)",
    "OAuth 1.0a authentication for user-specific operations",
    "batch operations and sorting",
    "private/public visibility controls",
    "analytics for Pro users (views, referrers)"
  ],
  "raw_analysis": "Flickr is a mature photo-sharing and social networking platform launched in 2004, acquired by Yahoo in 2005 and later by SmugMug in 2018. The service is designed for photographers, hobbyists, and creative communities to store, organize, share, and discover photos and videos. It offers a web interface, mobile apps, and a comprehensive public REST API that has been stable for over a decade. The API supports OAuth 1.0a for authentication, allowing third-party apps to access user content with permission. Integration possibilities include photo management tools, social applications, analytics dashboards, and content syndication. The platform has a freemium model with a free tier offering 1TB of storage and a Pro subscription with unlimited storage and advanced features. API usage is generally free for non-commercial purposes, but commercial use requires approval and may incur fees or restrictions. Rate limits are in place to prevent abuse, typically 3600 requests per hour per user and API key. Flickr's API is well-documented with many endpoints, making it a robust platform for building applications that require photo storage, metadata retrieval, and social interactions. The service has a strong user base and is particularly valuable for photographers and organizations needing visual content management. However, its maturity means the API is somewhat dated (OAuth 1.0a is legacy) and may have limitations compared to modern cloud services, but it remains a reliable option for photo-centric applications. Key integrations include content management systems (CMS), social media aggregators, and photo backup tools. Overall, it's a solid platform for building applications that need photo hosting, but developers should review current pricing and usage policies for commercial scenarios."
}

1/3 tests passed

```json
{
  "overall": 62,
  "dimensions": {
    "token_efficiency": 7.5,
    "first_try_success": 6.0,
    "response_parseability": 6.5,
    "error_clarity": 5.0,
    "doc_quality": 6.0,
    "auth_simplicity": 4.5,
    "latency": 8.5,
    "consistency": 7.0
  },
  "pricing_normalized": {
    "free_tier": "1TB storage with ads, limited uploads",
    "pro_subscription": "Unlimited storage, ad-free, analytics",
    "api_usage": "Free for non-commercial, approval required for commercial, rate limits"
  },
  "issues": [
    "OAuth 1.0a is outdated and complex compared to modern OAuth 2.0/JWT — increases integration friction for agents",
    "No /llms.txt file — missing AI-friendly documentation for agents",
    "robots.txt returns 404 — poor crawlability signals for automated clients",
    "Commercial API usage requires manual approval — not a frictionless path for agents",
    "Auth simplicity scores low due to signature-based OAuth 1.0a handshake requirements"
  ],
  "recommendations": [
    "Add /llms.txt documenting API endpoints, auth flow, and rate limits for agent consumption",
    "Consider adding an API key option for simple public reads (no OAuth dance) for non-user-specific operations",
    "Publish a clear robots.txt with API documentation paths",
    "Simplify commercial API access with instant approval or self-service tiers for small-volume agents"
  ]
}
```