Pinterest

{
  "service_type": "platform",
  "base_url": "https://developers.pinterest.com",
  "auth_method": "oauth2",
  "auth_config": {
    "authorization_url": "https://api.pinterest.com/oauth/",
    "token_url": "https://api.pinterest.com/v5/oauth/token",
    "scopes": ["boards:read", "boards:write", "pins:read", "pins:write", "user_accounts:read"],
    "grant_types": ["authorization_code", "client_credentials"]
  },
  "endpoints": [],
  "pricing_model": {"type": "freemium", "details": {"public_api": "free with rate limits", "paid_plans": "unclear, individual service tiers"}},
  "rate_limits": {
    "api_version": "v5",
    "limits": "variable by endpoint, 1000 requests per hour typical for user token",
    "note": "Check per-endpoint limits in documentation"
  },
  "capabilities": [
    "search and discover user content (pins, boards)",
    "pin management (create, update, delete pins)",
    "board management (create, update, delete boards)",
    "user profile data access",
    "content suggestion and idea generation (Pinterest's core concept)",
    "third-party integration for social media marketing",
    "analytics and metrics for pins and boards (if access)",
    "upload and manage media assets",
    "support for various content types (images, videos)",
    "collaboration features (via boards)"
  ],
  "raw_analysis": "Pinterest is a visual discovery and bookmarking platform, often described as 'the world's catalog of ideas'. It allows users to curate and organize images, videos, and ideas into boards, and is widely used for inspiration in areas like DIY, fashion, home decor, recipes, and more. The developer portal provides a REST API (v5) for third-party integration, enabling access to user data, pin/board management, and content enrichment. The platform is mature, with a large user base and extensive community; the API is well-documented but may have limitations for accessing full user data due to privacy. It offers OAuth2 authentication, allowing apps to act on behalf of users. Pricing: The API itself appears to be free to use with rate limits, but there are unclear paid tiers for higher volume access or specialized services. The primary audience includes developers building social media management tools, content marketers, and apps that leverage Pinterest for inspiration or curation. Integrations are possible with various marketing automation, analytics, and design tools. The platform's capabilities focus on content discovery, curation, and sharing, not on real-time communication or complex workflows, but it does support rich media handling and user engagement features like comments and likes (though not fully exposed to API). Overall, Pinterest is a solid platform for consumer-focused applications, with a good API but some constraints on data availability."
}

2/3 tests passed

```json
{
  "overall": 48,
  "dimensions": {
    "token_efficiency": 6.0,
    "first_try_success": 4.0,
    "response_parseability": 5.0,
    "error_clarity": 5.0,
    "doc_quality": 5.0,
    "auth_simplicity": 3.0,
    "latency": 9.0,
    "consistency": 7.0
  },
  "pricing_normalized": {
    "has_free_tier": true,
    "has_paid_tiers": true,
    "pricing_clarity": "unclear - no documented pricing for API tiers"
  },
  "issues": [
    "llms.txt endpoint returns 500 error - no machine-readable platform documentation for agents",
    "No structured API documentation accessible via llms.txt - agents cannot discover endpoints programmatically",
    "Pinterest API requires complex OAuth2.0 app registration and approval process - not agent-friendly",
    "Auth requires human-in-the-loop for app approval and token generation - blocks autonomous agent onboarding",
    "Pricing model unclear for API access beyond free tier - unclear rate limits and costs",
    "Robots.txt blocks Bytespider specifically - suggests some AI crawlers may be restricted",
    "Platform is a consumer visual discovery tool - not designed as an agent-first API platform"
  ],
  "recommendations": [
    "Add a working llms.txt file with clear API documentation, endpoint schemas, and authentication guides",
    "Provide API keys or simplified OAuth flow that agents can self-serve without human approval",
    "Document clear rate limits, pricing tiers, and usage quotas in machine-readable format",
    "Add structured JSON responses for all API endpoints to improve parseability",
    "Create agent-specific getting-started guide with copy-paste examples"
  ]
}
```