GetTopPostsRequest

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/trendsapi-ai/json-schema/trendsapi-ai-get-top-posts-request-schema.json",
  "title": "GetTopPostsRequest",
  "description": "Live top posts for one hashtag, fetched on every call. Business plan.",
  "x-generated": "2026-10-29",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/trendsapi-ai-openapi.json#/components/schemas/GetTopPostsRequest",
  "properties": {
    "keyword": {
      "description": "The hashtag, with or without #.",
      "type": "string"
    },
    "limit": {
      "default": 20,
      "maximum": 20,
      "minimum": 1,
      "type": "integer"
    },
    "mode": {
      "const": "get_top_posts",
      "description": "Canonical name (matches the MCP tool).",
      "type": "string"
    },
    "source": {
      "description": "One platform.",
      "enum": [
        "TikTok",
        "Instagram"
      ],
      "type": "string"
    }
  },
  "required": [
    "mode",
    "source",
    "keyword"
  ],
  "type": "object"
}