Twitter

{
  "service_type": "platform",
  "base_url": "https://docs.x.com",
  "auth_method": "oauth2",
  "auth_config": {
    "oauth2": {
      "authorization_url": "https://api.x.com/2/oauth2/authorize",
      "token_url": "https://api.x.com/2/oauth2/token",
      "scopes": ["tweet.read", "tweet.write", "users.read", "follows.read", "follows.write", "offline.access"]
    }
  },
  "endpoints": [
    {"path": "/2/tweets", "method": "GET", "description": "Retrieve recent tweets by ID or query"},
    {"path": "/2/tweets", "method": "POST", "description": "Create a new tweet"},
    {"path": "/2/users", "method": "GET", "description": "Retrieve user information by ID or username"},
    {"path": "/2/tweets/search/recent", "method": "GET", "description": "Search recent tweets"},
    {"path": "/2/users/by/username/{username}", "method": "GET", "description": "Get user by username"},
    {"path": "/2/tweets/{id}", "method": "GET", "description": "Get a single tweet by ID"},
    {"path": "/2/tweets/{id}", "method": "DELETE", "description": "Delete a tweet"},
    {"path": "/2/tweets/{id}/liking_users", "method": "GET", "description": "Get users who liked a tweet"},
    {"path": "/2/users/{id}/likes", "method": "GET", "description": "Get liked tweets by a user"},
    {"path": "/2/users/{id}/likes", "method": "POST", "description": "Like a tweet"},
    {"path": "/2/users/{id}/likes/{tweet_id}", "method": "DELETE", "description": "Unlike a tweet"},
    {"path": "/2/tweets/{id}/retweeted_by", "method": "GET", "description": "Get users who retweeted a tweet"},
    {"path": "/2/users/{id}/retweets", "method": "POST", "description": "Retweet a tweet"},
    {"path": "/2/users/{id}/retweets/{source_tweet_id}", "method": "DELETE", "description": "Unretweet a tweet"},
    {"path": "/2/users/{id}/following", "method": "GET", "description": "Get users a user follows"},
    {"path": "/2/users/{id}/followers", "method": "GET", "description": "Get followers of a user"},
    {"path": "/2/users/{id}/following", "method": "POST", "description": "Follow a user"},
    {"path": "/2/users/{source_user_id}/following/{target_user_id}", "method": "DELETE", "description": "Unfollow a user"},
    {"path": "/2/tweets/search/stream/rules", "method": "GET", "description": "Get stream rules"},
    {"path": "/2/tweets/search/stream", "method": "GET", "description": "Stream tweets in real-time"}
  ],
  "pricing_model": {
    "type": "subscription",
    "details": {
      "free": "Limited access to write posts and read own data",
      "pro": "$100/month - 75k post reads, 10k post writes, 1 active app, 1 project",
      "enterprise": "Custom pricing for high-volume access (e.g., full archive search, academic research)"
    }
  },
  "rate_limits": {
    "free": "Request caps vary per endpoint; e.g., 1 request/15min for some user lookups",
    "pro": "Higher caps, e.g., 300 requests/15min for recent search",
    "enterprise": "Custom high-throughput limits"
  },
  "capabilities": [
    "Read and write posts (tweets)",
    "Search recent and full-archive tweets",
    "Retrieve user profiles and metadata",
    "Manage follows, likes, retweets",
    "Stream real-time tweets",
    "Access trends and place data",
    "Manage account settings (Limited)",
    "OAuth 2.0 and OAuth 1.0a auth",
    "Webhooks / Account Activity API (Enterprise)"
  ],
  "raw_analysis": "Twitter (now X) is a major social media platform with a mature, evolving developer API. The developer platform at docs.x.com (formerly developer.twitter.com) provides RESTful APIs for reading and writing tweets, user data, trends, and streaming. It is widely used for social media analytics, marketing automation, and AI training data. The API requires OAuth authentication (both OAuth 2.0 and OAuth 1.0a supported). Pricing moved to a tiered subscription model: Free, Pro ($100/month), and Enterprise (custom). Rate limits vary by endpoint and tier. Integrations include numerous third-party tools like Zapier, Hootsuite, and custom applications via SDKs in multiple languages. The platform is mature but undergoes frequent changes (recent rebranding to X, API versioning to v2). Developers should check current documentation for latest terms and pricing."
}

3/3 tests passed

```json
{
  "overall": 62,
  "dimensions": {
    "token_efficiency": 6.5,
    "first_try_success": 4.0,
    "response_parseability": 7.5,
    "error_clarity": 5.5,
    "doc_quality": 7.0,
    "auth_simplicity": 5.0,
    "latency": 8.0,
    "consistency": 6.0
  },
  "pricing_normalized": {
    "free_tier": "Limited - write posts, read own data",
    "pro_monthly": 100,
    "enterprise": "Custom pricing for high-volume/full archive"
  },
  "issues": [
    "High cost for basic API access ($100/month Pro tier) compared to alternatives",
    "OAuth 2.0 with multiple flow types adds complexity for agents",
    "Limited account settings management capability (noted as 'Limited' in docs)",
    "Full-archive search only available on enterprise plans",
    "Free tier severely restricted - not viable for production use",
    "Webhook/streaming features gated behind enterprise tier"
  ],
  "recommendations": [
    "Consider free alternatives (e.g., Mastodon API, Bluesky) for basic posting/search",
    "If X is required, budget for Pro tier at minimum - ensure use case justifies $100/month",
    "Leverage llms.txt and MCP support for structured agent integration",
    "Use OAuth 2.0 PKCE flow for simpler agent authorization",
    "Check if Academic Research access applies (offers higher limits)"
  ]
}
```