Giphy

{
  "service_type": "platform",
  "base_url": "https://developers.giphy.com/docs",
  "auth_method": "api_key",
  "auth_config": {
    "type": "api_key",
    "location": "query",
    "header_name": null,
    "query_param_name": "api_key",
    "description": "A GIPHY API key is required for all API requests. It must be passed as a query parameter in each request. Get a key from the GIPHY Developers portal after creating an app."
  },
  "endpoints": [
    {
      "name": "Search GIFs",
      "method": "GET",
      "path": "/v1/gifs/search",
      "description": "Search for GIFs matching a query term, with optional filters (rating, lang, limit, offset).",
      "auth_required": true
    },
    {
      "name": "Get GIF by ID",
      "method": "GET",
      "path": "/v1/gifs/{gif_id}",
      "description": "Retrieve a single GIF object by its unique ID.",
      "auth_required": true
    },
    {
      "name": "Get GIFs by IDs",
      "method": "GET",
      "path": "/v1/gifs",
      "description": "Retrieve multiple GIF objects by a comma-separated list of IDs.",
      "auth_required": true
    },
    {
      "name": "Trending GIFs",
      "method": "GET",
      "path": "/v1/gifs/trending",
      "description": "Fetch a list of GIFs currently trending on GIPHY.",
      "auth_required": true
    },
    {
      "name": "Translate GIFs",
      "method": "GET",
      "path": "/v1/gifs/translate",
      "description": "Translate a word or phrase into a GIF using natural language understanding.",
      "auth_required": true
    },
    {
      "name": "Random GIF",
      "method": "GET",
      "path": "/v1/gifs/random",
      "description": "Get a random GIF from GIPHY, with optional tag filtering.",
      "auth_required": true
    },
    {
      "name": "Upload GIF",
      "method": "POST",
      "path": "/v1/gifs",
      "description": "Upload a GIF to GIPHY, requiring a file or source URL, with optional tags.",
      "auth_required": true
    },
    {
      "name": "Sticker Search",
      "method": "GET",
      "path": "/v1/stickers/search",
      "description": "Search for stickers matching a query term.",
      "auth_required": true
    },
    {
      "name": "Sticker Trending",
      "method": "GET",
      "path": "/v1/stickers/trending",
      "description": "Fetch trending stickers on GIPHY.",
      "auth_required": true
    },
    {
      "name": "Sticker Translate",
      "method": "GET",
      "path": "/v1/stickers/translate",
      "description": "Translate a word or phrase into a sticker.",
      "auth_required": true
    },
    {
      "name": "Sticker Random",
      "method": "GET",
      "path": "/v1/stickers/random",
      "description": "Get a random sticker, optionally filtered by tag.",
      "auth_required": true
    },
    {
      "name": "Clips Search",
      "method": "GET",
      "path": "/v1/clips/search",
      "description": "Search for video clips (Clips) matching a query.",
      "auth_required": true
    },
    {
      "name": "Clips Trending",
      "method": "GET",
      "path": "/v1/clips/trending",
      "description": "Fetch trending video clips on GIPHY.",
      "auth_required": true
    },
    {
      "name": "Clips Translate",
      "method": "GET",
      "path": "/v1/clips/translate",
      "description": "Translate a word or phrase into a video clip.",
      "auth_required": true
    },
    {
      "name": "Clips Random",
      "method": "GET",
      "path": "/v1/clips/random",
      "description": "Get a random video clip, optionally filtered by tag.",
      "auth_required": true
    },
    {
      "name": "Emoji Endpoint",
      "method": "GET",
      "path": "/v1/emoji",
      "description": "Retrieve a list of emoji stickers provided by GIPHY.",
      "auth_required": true
    },
    {
      "name": "Text Endpoint",
      "method": "GET",
      "path": "/v1/text",
      "description": "Retrieve text-based content generated by GIPHY.",
      "auth_required": true
    }
  ],
  "pricing_model": {
    "type": "freemium",
    "details": {
      "free_tier": "Available with rate limits (e.g., 42 requests/hour per API key in production).",
      "paid_tier": "Higher usage limits may be available for enterprise or approved applications; no public pricing structure provided in docs.",
      "usage_notes": "API key required for all requests; rate limits documented at https://developers.giphy.com/docs/optional-settings/#rate-limits."
    }
  },
  "rate_limits": {
    "free_production": "42 requests/hour per API key (production), 10,000 requests/hour in beta is a common historical figure; exact details likely in docs.",
    "example_request_limit": "42/hour for production apps, but check docs for current limits and exceptions."
  },
  "capabilities": [
    "Search for GIFs, stickers, clips, emoji, and text",
    "Retrieve trending content across all content types",
    "Translate natural language phrases into GIFs/stickers/clips",
    "Get random content filtered by tags",
    "Upload cust

2/3 tests passed

```json
{
  "overall": 82,
  "dimensions": {
    "token_efficiency": 8.5,
    "first_try_success": 7.5,
    "response_parseability": 9.5,
    "error_clarity": 7.0,
    "doc_quality": 9.0,
    "auth_simplicity": 7.0,
    "latency": 8.5,
    "consistency": 8.0
  },
  "pricing_normalized": {
    "free_tier": "42 req/hour",
    "paid_tier": "not publicly priced",
    "model": "freemium"
  },
  "issues": [
    "Rate limit of 42 requests/hour is extremely low for production use",
    "No public pricing for paid tier - requires contacting sales/enterprise",
    "robots.txt returns 404 (minor issue)",
    "Auth requires API key creation through developer portal (not SSO)",
    "Pricing for higher tiers is opaque, making cost estimation for agents difficult"
  ],
  "recommendations": [
    "Document paid tier pricing more transparently to allow agents to estimate costs",
    "Increase free tier rate limits to at least 100 req/hour for basic testing",
    "Add a public pricing page with clear tiers",
    "Consider adding SSO/OAuth simplification for developers",
    "Add robots.txt file to improve crawler guidance"
  ]
}
```