Captapi

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "days": {
      "type": "integer",
      "minimum": 1,
      "description": "Number of days to include (default 30, max 365)."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "days": {
      "type": "integer",
      "minimum": 1,
      "description": "Number of days to include (default 30, max 365)."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "description": "Max rows to return (default 20, max 100). Free — does not consume credits."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "minimum": 1,
      "description": "Max rows to return (default 50, max 500). Free — does not consume credits."
    },
    "since": {
      "type": "string",
      "description": "Inclusive lower bound on createdAt (ISO date or datetime)."
    },
    "until": {
      "type": "string",
      "description": "Exclusive upper bound on createdAt (ISO date or datetime)."
    },
    "cursor": {
      "type": "string",
      "description": "Pagination cursor from nextCursor (createdAt of the last row). Leave empty for the first page."
    },
    "endpoint": {
      "type": "string",
      "description": "Exact Captapi path filter, e.g. /v1/instagram/basic-profile."
    },
    "statusCode": {
      "type": "integer",
      "minimum": 1,
      "description": "Filter by HTTP status code (e.g. 500)."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "url"
  ],
  "properties": {
    "url": {
      "type": "string",
      "format": "uri",
      "description": "Amazon seller storefront URL (/sp?seller=… or /s?me=…) or raw seller ID. Not influencer /shop/<handle> pages. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble."
    },
    "cache": {
      "type": "boolean",
      "description": "Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "description": "Max products to include (default 20, max 200; 0 = seller metadata only). Billed per 16-product storefront page: ceil(limit / 16) credits, minimum 1 — the default 20 costs 2."
    },
    "cursor": {
      "type": "string",
      "description": "Pagination cursor from nextCursor (page or page:offset). Leave empty for the first page."
    },
    "marketplace": {
      "type": "string",
      "description": "Amazon marketplace code. Default US."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "urls"
  ],
  "properties": {
    "urls": {
      "type": "string",
      "description": "Comma-separated post/video/reel URLs (up to 10), any mix of the same 11 platforms as Post Analytics. Example: a TikTok URL and a YouTube URL in one call."
    },
    "cache": {
      "type": "boolean",
      "description": "Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "url"
  ],
  "properties": {
    "url": {
      "type": "string",
      "format": "uri",
      "description": "Public post/video/reel URL from one of 11 platforms: YouTube, TikTok, Instagram, Facebook, X, Reddit, Threads, Bluesky, Pinterest, LinkedIn, or Rumble. Platform is auto-detected — cross-platform URLs are expected here (unlike single-platform endpoints). Not in scope: Kwai, Twitch, Spotify, Snapchat, and other Captapi platforms."
    },
    "cache": {
      "type": "boolean",
      "description": "Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "url"
  ],
  "properties": {
    "url": {
      "type": "string",
      "format": "uri",
      "description": "Bluesky post URL, e.g. https://bsky.app/profile/handle/post/RKEY. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble."
    },
    "cache": {
      "type": "boolean",
      "description": "Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh."
    },
    "depth": {
      "type": "integer",
      "minimum": 1,
      "description": "Reply nesting levels under the post (0 = post only with no replies[], default 1, max 6). Maps to Bluesky getPostThread depth."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "url"
  ],
  "properties": {
    "url": {
      "type": "string",
      "format": "uri",
      "description": "Bluesky profile URL, @handle, or handle, e.g. bsky.app/profile/handle. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble."
    },
    "cache": {
      "type": "boolean",
      "description": "Set true to serve from the response cache (default TTL). Default false — always fetch fresh. Prefer cacheMaxAge when you need 1d–30d freshness control."
    },
    "cacheMaxAge": {
      "type": "string",
      "description": "Max age of a cached response: 1d, 3d, 7d, 14d, or 30d. When set, enables caching with that TTL."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "url"
  ],
  "properties": {
    "url": {
      "type": "string",
      "format": "uri",
      "description": "Meta Ad Library ad URL or ad ID. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble."
    },
    "cache": {
      "type": "boolean",
      "description": "Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "url"
  ],
  "properties": {
    "url": {
      "type": "string",
      "format": "uri",
      "description": "Meta Ad Library ad URL or ad ID. Returns the ad's written copy — headline, body text, CTA and landing URL. Meta does not expose ad audio, so this is not a speech transcript. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble."
    },
    "cache": {
      "type": "boolean",
      "description": "Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "q"
  ],
  "properties": {
    "q": {
      "type": "string",
      "description": "Company or brand name to search for (min 2 characters). Name-matched — off-brand pages are dropped."
    },
    "cache": {
      "type": "boolean",
      "description": "Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "description": "Max items to return (default 20, max 200). Flat 2 credits per call."
    },
    "country": {
      "type": "string",
      "description": "Two-letter ISO country code. Default US. Non-ISO codes are a definitive 400 INVALID_COUNTRY."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "url",
    "commentId"
  ],
  "properties": {
    "url": {
      "type": "string",
      "format": "uri",
      "description": "Facebook post URL the comment belongs to. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble."
    },
    "cache": {
      "type": "boolean",
      "description": "Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "description": "Max items to return (default 50, max 500). Flat 2 credits per call."
    },
    "commentId": {
      "type": "string",
      "description": "ID of the parent (top-level) comment to fetch replies for — from the comments endpoint. Legacy alias: comment_id."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "url": {
      "type": "string",
      "format": "uri",
      "description": "Facebook post or Reel URL. Omit when feedbackId is set. The URL platform must match this endpoint's platform. A page/profile URL also works: Facebook renders the page's most recent post first, so you get that post's comments (each comment's url names the actual post)."
    },
    "cache": {
      "type": "boolean",
      "description": "Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "description": "Max items to return (default 50, max 500). Flat 2 credits per call."
    },
    "feedbackId": {
      "type": "string",
      "description": "Post feedback id from /v1/facebook/details (base64 feedback:POSTID). Prefer when you already have it — also accepts feedback_id."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "url"
  ],
  "properties": {
    "url": {
      "type": "string",
      "format": "uri",
      "description": "Public Facebook video or post URL. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble."
    },
    "cache": {
      "type": "boolean",
      "description": "Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "url"
  ],
  "properties": {
    "url": {
      "type": "string",
      "format": "uri",
      "description": "Facebook event URL, e.g. https://facebook.com/events/ID. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble."
    },
    "cache": {
      "type": "boolean",
      "description": "Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "q"
  ],
  "properties": {
    "q": {
      "type": "string",
      "description": "Topic keyword, e.g. 'comedy'. Pair with location for city-scoped results."
    },
    "to": {
      "type": "string",
      "description": "Inclusive local start date filter YYYY-MM-DD."
    },
    "from": {
      "type": "string",
      "description": "Inclusive local start date filter YYYY-MM-DD. Use for upcoming-only windows — Facebook/SERP may return past events."
    },
    "cache": {
      "type": "boolean",
      "description": "Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "description": "Max items to return (default 20, max 200). Flat 2 credits per call. Response `source` is native or extended (fetch path — not a price change)."
    },
    "location": {
      "type": "string",
      "description": "City/place geo filter (e.g. London). Matches timezone, location.city, or coords near the city — not a title substring."
    },
    "upcoming": {
      "type": "boolean",
      "description": "When true and from is omitted, sets from to today's UTC date so past events are dropped."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "url"
  ],
  "properties": {
    "url": {
      "type": "string",
      "format": "uri",
      "description": "Public Facebook group URL, e.g. https://facebook.com/groups/ID. Must contain /groups/ — profile/page URLs are a definitive 400 (use /v1/facebook/profile-posts for those). The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble."
    },
    "cache": {
      "type": "boolean",
      "description": "Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "description": "Max posts to return (default 20, max 200; up to 80 per call — above that you get 80 with truncatedReason per-call-cap). Billed 1 credit per returned post, minimum 2."
    },
    "sortBy": {
      "type": "string",
      "description": "TOP_POSTS | RECENT_ACTIVITY | CHRONOLOGICAL (default) | CHRONOLOGICAL_LISTINGS. Maps to Facebook sorting_setting."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "url"
  ],
  "properties": {
    "url": {
      "type": "string",
      "format": "uri",
      "description": "Facebook Marketplace item URL. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble."
    },
    "cache": {
      "type": "boolean",
      "description": "Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "q"
  ],
  "properties": {
    "q": {
      "type": "string",
      "description": "City/place query. Bare names like 'Austin' may return multiple candidates (TX/MN/IN); include a state for a single hit (e.g. 'Austin, TX')."
    },
    "cache": {
      "type": "boolean",
      "description": "Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "description": "Max items to return (default 10, max 50). Flat 2 credits per call."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "url"
  ],
  "properties": {
    "url": {
      "type": "string",
      "format": "uri",
      "description": "Facebook page URL, @handle, or page name, e.g. https://facebook.com/PageName. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble."
    },
    "cache": {
      "type": "boolean",
      "description": "Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "url"
  ],
  "properties": {
    "url": {
      "type": "string",
      "format": "uri",
      "description": "Facebook profile/page URL, @handle, or page name. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble."
    },
    "cache": {
      "type": "boolean",
      "description": "Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "description": "Max items to return (default 20, max 200). Flat 2 credits per call. Response `source` is native or extended (fetch path — not a price change)."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "url"
  ],
  "properties": {
    "url": {
      "type": "string",
      "format": "uri",
      "description": "Facebook profile/page URL, @handle, or page name. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble."
    },
    "cache": {
      "type": "boolean",
      "description": "Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "description": "Max items to return (default 20, max 200). The public /photos grid is a single SSR batch (often ~8) — retrievableCount is that batch, not a promise Facebook will fill limit. Flat 2 credits per call."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "url"
  ],
  "properties": {
    "url": {
      "type": "string",
      "format": "uri",
      "description": "Facebook profile/page URL, @handle, or page name. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble."
    },
    "cache": {
      "type": "boolean",
      "description": "Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "description": "Max items to return (default 4, max 4). The logged-out listing hop is ~23–29s typical, hard-capped at 40s. Each hydrate is typically 6–10s (can be ~100ms when listing already carried the post) and is capped at 12s. The next-item fit check uses that 12s cap, not the typical 6–10s, so a call cannot exceed 60s. The loop stops when the next item would miss the 60s deadline and returns what it has (truncatedReason=hydrate-budget | deadline). Asking for 20 cannot return 20 inside that ceiling. Flat 2 credits per call."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "url"
  ],
  "properties": {
    "url": {
      "type": "string",
      "format": "uri",
      "description": "Facebook profile/page URL, @handle, or page name. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble."
    },
    "cache": {
      "type": "boolean",
      "description": "Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "description": "Max items to return (default 20, max 200). Flat 2 credits per call."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "url"
  ],
  "properties": {
    "url": {
      "type": "string",
      "format": "uri",
      "description": "Public Facebook video or post URL. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble."
    },
    "cache": {
      "type": "boolean",
      "description": "Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "username"
  ],
  "properties": {
    "cache": {
      "type": "boolean",
      "description": "Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "description": "Max items to return (default 30, max 90). Billed per result."
    },
    "cursor": {
      "type": "string",
      "description": "Opaque cursor from a previous nextCursor. Pagination stops after GitHub's 90-event public activity ceiling."
    },
    "username": {
      "type": "string",
      "description": "GitHub username or profile URL, e.g. getify."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "username"
  ],
  "properties": {
    "cache": {
      "type": "boolean",
      "description": "Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh."
    },
    "username": {
      "type": "string",
      "description": "GitHub username or profile URL, e.g. getify or https://github.com/getify."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "username"
  ],
  "properties": {
    "cache": {
      "type": "boolean",
      "description": "Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "description": "Max items to return (default 30, max 100). Billed per result."
    },
    "cursor": {
      "type": "string",
      "description": "Opaque cursor from a previous nextCursor (GitHub Link page=). Not a bare page number."
    },
    "username": {
      "type": "string",
      "description": "GitHub username or profile URL, e.g. getify."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "username"
  ],
  "properties": {
    "cache": {
      "type": "boolean",
      "description": "Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "description": "Max items to return (default 30, max 100). Billed per result."
    },
    "cursor": {
      "type": "string",
      "description": "Opaque cursor from a previous nextCursor (GitHub Link page=). Not a bare page number."
    },
    "username": {
      "type": "string",
      "description": "GitHub username or profile URL, e.g. getify."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "repo"
  ],
  "properties": {
    "repo": {
      "type": "string",
      "description": "Repository URL or owner/name, e.g. vercel/next.js."
    },
    "cache": {
      "type": "boolean",
      "description": "Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "description": "Max items to return (default 30, max 100). Billed per result."
    },
    "state": {
      "type": "string",
      "description": "open (API default), closed, or all. Echoed as data.state. Docs example uses closed so mergedAt is visible."
    },
    "cursor": {
      "type": "string",
      "description": "Opaque cursor from a previous nextCursor (GitHub Link page=). Not a bare page number."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "username"
  ],
  "properties": {
    "sort": {
      "type": "string",
      "description": "created | updated | pushed | full_name (default updated). Not stars — GitHub's user-repos API has no stars sort. Echoed as data.sort."
    },
    "type": {
      "type": "string",
      "description": "owner (default) | member | all — affiliation filter. Echoed as data.type."
    },
    "cache": {
      "type": "boolean",
      "description": "Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "description": "Max items to return (default 30, max 100). Billed per result."
    },
    "cursor": {
      "type": "string",
      "description": "Opaque cursor from a previous nextCursor (GitHub Link page=). Not a bare page number."
    },
    "username": {
      "type": "string",
      "description": "GitHub username or profile URL, e.g. torvalds."
    },
    "direction": {
      "type": "string",
      "description": "asc or desc (default desc). Echoed as data.direction."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "repo"
  ],
  "properties": {
    "repo": {
      "type": "string",
      "description": "Repository URL or owner/name, e.g. torvalds/linux or https://github.com/torvalds/linux."
    },
    "cache": {
      "type": "boolean",
      "description": "Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "cache": {
      "type": "boolean",
      "description": "Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "description": "Max items to return (default 25, max 100). Flat 2 credits per call."
    },
    "since": {
      "type": "string",
      "description": "Trending window: daily (default), weekly, or monthly — matches github.com/trending/developers?since=."
    },
    "language": {
      "type": "string",
      "description": "Optional programming-language slug → /trending/developers/{language}."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "cache": {
      "type": "boolean",
      "description": "Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "description": "Max items to return (default 25, max 100). Flat 2 credits per call."
    },
    "since": {
      "type": "string",
      "description": "Trending window: daily (default), weekly, or monthly — matches github.com/trending?since=."
    },
    "language": {
      "type": "string",
      "description": "Optional programming-language slug (e.g. python, typescript) → /trending/{language}."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "username"
  ],
  "properties": {
    "cache": {
      "type": "boolean",
      "description": "Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh."
    },
    "username": {
      "type": "string",
      "description": "GitHub username or profile URL, e.g. getify or https://github.com/getify."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "creative_id"
  ],
  "properties": {
    "cache": {
      "type": "boolean",
      "description": "Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh."
    },
    "country": {
      "type": "string",
      "description": "Two-letter ISO country code. Default US. Non-ISO codes are a definitive 400 INVALID_COUNTRY."
    },
    "creative_id": {
      "type": "string",
      "description": "Google Ads Transparency URL containing AR... advertiser and CR... creative IDs. A creative that does not exist under the advertiser is a definitive 404 AD_NOT_FOUND (upstream answered) — 503 is reserved for actual transport failures."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "q"
  ],
  "properties": {
    "q": {
      "type": "string",
      "description": "Brand, domain, or advertiser name (min 2 characters). Expanded + ranked so US prefers Inc. over SRL."
    },
    "cache": {
      "type": "boolean",
      "description": "Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "description": "Max items to return (default 10, max 50). Flat 1 credit when results are returned; 0 credits when totalReturned is 0."
    },
    "country": {
      "type": "string",
      "description": "Two-letter ISO country code used for ranking (e.g. US). Default US. Non-ISO codes are a definitive 400 INVALID_COUNTRY."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "q"
  ],
  "properties": {
    "q": {
      "type": "string",
      "description": "Keyword, for example plumber or coffee. Min 2 characters."
    },
    "cache": {
      "type": "boolean",
      "description": "Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "description": "Max businesses to return (default 20, max 100). Not a page cursor — there is no next page. Flat 2 credits per call; zero businesses is 0 credits."
    },
    "language": {
      "type": "string",
      "description": "Language code, for example en. Default en."
    },
    "location": {
      "type": "string",
      "description": "Place name: City, Country or City, Region, Country — for example Austin, TX, Istanbul, Turkey, Paris, France, or a country such as Germany. Case, accents, US state codes, and country aliases (USA, UK, Turkey) are handled. A city name shared by several places (Paris) returns 400 with suggestions. When set, the locationCode parameter is ignored."
    },
    "locationCode": {
      "type": "integer",
      "minimum": 1,
      "description": "Numeric place code, used only when location is omitted. Default 2840 (United States)."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "userId"
  ],
  "properties": {
    "cache": {
      "type": "boolean",
      "description": "Set true to serve from the response cache (default TTL). Default false — always fetch fresh. Prefer cacheMaxAge when you need 1d–30d freshness control."
    },
    "userId": {
      "type": "string",
      "description": "Instagram numeric pk (e.g. 13460080 — the id field on this endpoint), or a profile URL / @handle / username. A Facebook/Graph fbid (17-digit 17841…) is 400 WRONG_ID_TYPE."
    },
    "cacheMaxAge": {
      "type": "string",
      "description": "Max age of a cached response: 1d, 3d, 7d, 14d, or 30d. When set, enables caching with that TTL."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "url"
  ],
  "properties": {
    "url": {
      "type": "string",
      "format": "uri",
      "description": "Instagram profile URL, @handle, or username, e.g. https://instagram.com/username/. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble."
    },
    "cache": {
      "type": "boolean",
      "description": "Set true to serve from the response cache (default TTL). Default false — always fetch fresh. Prefer cacheMaxAge when you need 1d–30d freshness control."
    },
    "cacheMaxAge": {
      "type": "string",
      "description": "Max age of a cached response: 1d, 3d, 7d, 14d, or 30d. When set, enables caching with that TTL."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "url"
  ],
  "properties": {
    "url": {
      "type": "string",
      "format": "uri",
      "description": "Instagram profile URL, @handle, or username, e.g. https://instagram.com/username/. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble."
    },
    "cache": {
      "type": "boolean",
      "description": "Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "description": "Max items to return (default 20, max 200). Billed per result."
    },
    "cursor": {
      "type": "string",
      "description": "Pagination cursor. Leave empty for the first page; then pass the nextCursor value returned in the previous response (e.g. 3937014945555313553_1697296). A null nextCursor means the end of the list."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "url": {
      "type": "string",
      "format": "uri",
      "description": "Instagram profile URL, @handle, or username. Omit when userId is set. The URL platform must match this endpoint's platform."
    },
    "cache": {
      "type": "boolean",
      "description": "Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "description": "Max items to return (default 20, max 200). Billed per result."
    },
    "cursor": {
      "type": "string",
      "description": "Pagination cursor. Leave empty for the first page; then pass nextCursor from the previous response (clips:{userId}:{opaque} on the native Reels path, or legacy {mediaId}_{userId}). Stop when hasMore is false."
    },
    "userId": {
      "type": "string",
      "description": "Instagram numeric user ID (e.g. 173560420). Skips handle→ID resolve (legacy sequential WPI alone could cost ~80s). Prefer when you already have the ID from basic-profile or profile-search."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "url"
  ],
  "properties": {
    "url": {
      "type": "string",
      "format": "uri",
      "description": "Instagram post or reel URL, e.g. https://instagram.com/reel/ID/. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble."
    },
    "cache": {
      "type": "boolean",
      "description": "Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "description": "Max items to return (default 50, max 500). Billed per result."
    },
    "cursor": {
      "type": "string",
      "description": "Pagination cursor from the previous nextCursor ({mediaPk}:{minId}). Omit on the first page. hasMore is true when nextCursor is set, or when more exist and cannot be paged (nextCursor null + truncatedReason)."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "url"
  ],
  "properties": {
    "url": {
      "type": "string",
      "format": "uri",
      "description": "Instagram post or reel URL, e.g. https://instagram.com/reel/ID/. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble."
    },
    "cache": {
      "type": "boolean",
      "description": "Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "url"
  ],
  "properties": {
    "url": {
      "type": "string",
      "format": "uri",
      "description": "Instagram post, reel, or profile URL (or @handle), e.g. https://instagram.com/reel/ID/ or https://instagram.com/username/. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble."
    },
    "cache": {
      "type": "boolean",
      "description": "Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "q"
  ],
  "properties": {
    "q": {
      "type": "string",
      "description": "Hashtag without the # (min 2 characters). One token — spaces are 400 HASHTAG_HAS_SPACES."
    },
    "cache": {
      "type": "boolean",
      "description": "Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "description": "Max items to return (default 20, max 50). Flat 2 credits per call."
    },
    "mediaType": {
      "type": "string",
      "description": "all (default) or reels — return only Reels/clips when set to reels."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "url": {
      "type": "string",
      "format": "uri",
      "description": "Instagram profile URL, @handle, or username. Omit when userId is set."
    },
    "cache": {
      "type": "boolean",
      "description": "Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh."
    },
    "userId": {
      "type": "string",
      "description": "Numeric Instagram user ID. Prefer when known — skips handle→ID resolve. When only userId is set we reverse-resolve the username so the WPI / profile-HTML shelf can still run."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "Highlight id from /v1/instagram/highlights (with or without highlight: prefix)."
    },
    "cache": {
      "type": "boolean",
      "description": "Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "q"
  ],
  "properties": {
    "q": {
      "type": "string",
      "description": "Account name, @handle, or profile URL to resolve (min 2 characters). A leading _, accents (misión → mision), spaces and URL query strings (?igsh=…) are stripped. A q with no usable username characters is 400 BAD_REQUEST. Not a niche keyword search."
    },
    "cache": {
      "type": "boolean",
      "description": "Serve from the 24h shared cache when available (0 credits on hit). Default true — set false to always fetch fresh."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "audioId"
  ],
  "properties": {
    "cache": {
      "type": "boolean",
      "description": "Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "description": "Max items to return (default 20, max 200). Billed per result."
    },
    "audioId": {
      "type": "string",
      "description": "Instagram audio/music ID or full audio URL, e.g. 27919946310946207."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "q"
  ],
  "properties": {
    "q": {
      "type": "string",
      "description": "Hashtag without the # (min 2 characters). One token — spaces are 400 HASHTAG_HAS_SPACES."
    },
    "cache": {
      "type": "boolean",
      "description": "Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "description": "Max items to return (default 20, max 50). Flat 2 credits per call."
    },
    "datePosted": {
      "type": "string",
      "description": "last_24_hours | last_week | last_month | last_year (aliases: today, this_week, this_month, this_year)."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "url"
  ],
  "properties": {
    "url": {
      "type": "string",
      "format": "uri",
      "description": "Instagram Reel URL, e.g. https://instagram.com/reel/ID/. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble."
    },
    "cache": {
      "type": "boolean",
      "description": "Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh."
    },
    "language": {
      "type": "string",
      "description": "ISO code, e.g. \"tr\": pins the speech language and sets the summary output language. Defaults to auto-detect + English summary."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "url"
  ],
  "properties": {
    "url": {
      "type": "string",
      "format": "uri",
      "description": "Instagram profile URL, @handle, or username, e.g. https://instagram.com/username/. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble."
    },
    "cache": {
      "type": "boolean",
      "description": "Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "description": "Max items to return (default 20, max 200). Flat 1 credit per call."
    },
    "cursor": {
      "type": "string",
      "description": "Leave empty for the first page; then pass the nextCursor value returned in the previous response."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "url"
  ],
  "properties": {
    "url": {
      "type": "string",
      "format": "uri",
      "description": "Instagram Reel URL, e.g. https://instagram.com/reel/ID/. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble."
    },
    "cache": {
      "type": "boolean",
      "description": "Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh."
    },
    "language": {
      "type": "string",
      "description": "Preferred caption language as an ISO code, e.g. \"en\". Defaults to auto-detect."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "cache": {
      "type": "boolean",
      "description": "Default true (cache-first): serve the per-country response cache when present (TTL 4 hours). Every successful call costs 2 credits — including cache hits. Set false to force a live scrape (measured miss 45–75s, hard-capped at 110s). Raise client timeouts above 90s — n8n/Make defaults will fail a miss. The fresh result still refreshes the cache."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "description": "Max items to return (default 10, max 50). Flat 2 credits per call."
    },
    "country": {
      "type": "string",
      "description": "Country for Reels localization — full name or ISO code (e.g. 'United States', 'US', 'Turkey', 'TR'). Default United States. Unsupported values return 400 with supportedCountries[]."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "url"
  ],
  "properties": {
    "url": {
      "type": "string",
      "format": "uri",
      "description": "Kick clip URL for one enriched clip (e.g. https://kick.com/{channel}/clips/clip_…), or channel input for recent clips[]: kick.com/{name}, kick.com/@{name}, @{name}, or {name}. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble."
    },
    "cache": {
      "type": "boolean",
      "description": "Set true to serve from the response cache (default TTL). Default false — always fetch fresh. Prefer cacheMaxAge when you need 1d–30d freshness control."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "description": "Channel mode only — max recent clips to return (default 30, max 100). Ignored when url is a clip. Flat 1 credit. No cursor — Kick returns a single page."
    },
    "cacheMaxAge": {
      "type": "string",
      "description": "Max age of a cached response: 1d, 3d, 7d, 14d, or 30d. When set, enables caching with that TTL."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "url"
  ],
  "properties": {
    "url": {
      "type": "string",
      "format": "uri",
      "description": "Komi page URL or username, e.g. https://komi.io/kimkardashian or https://kimkardashian.komi.io/. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble."
    },
    "cache": {
      "type": "boolean",
      "description": "Set true to serve from the response cache (default TTL). Default false — always fetch fresh. Prefer cacheMaxAge when you need 1d–30d freshness control."
    },
    "cacheMaxAge": {
      "type": "string",
      "description": "Max age of a cached response: 1d, 3d, 7d, 14d, or 30d. When set, enables caching with that TTL."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "url"
  ],
  "properties": {
    "url": {
      "type": "string",
      "format": "uri",
      "description": "Kwai video URL, e.g. https://www.kwai.com/@topfilmeseseriesnatv/video/5240932700689736196. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble."
    },
    "cache": {
      "type": "boolean",
      "description": "Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "url"
  ],
  "properties": {
    "url": {
      "type": "string",
      "format": "uri",
      "description": "Kwai profile URL or @handle, e.g. https://www.kwai.com/@topfilmeseseriesnatv. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble."
    },
    "cache": {
      "type": "boolean",
      "description": "Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "url"
  ],
  "properties": {
    "url": {
      "type": "string",
      "format": "uri",
      "description": "Kwai profile URL or @handle, e.g. https://www.kwai.com/@topfilmeseseriesnatv. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble."
    },
    "cache": {
      "type": "boolean",
      "description": "Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "description": "Max posts to return (1–200). Default 20. ~1 credit per post returned (min 2)."
    },
    "cursor": {
      "type": "string",
      "description": "Opaque pagination cursor from the previous nextCursor. Pages within posts from one profile fetch."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "url"
  ],
  "properties": {
    "url": {
      "type": "string",
      "format": "uri",
      "description": "Linkbio (lnk.bio) page URL or username, e.g. https://lnk.bio/charlidamelio. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble."
    },
    "cache": {
      "type": "boolean",
      "description": "Set true to serve from the response cache (default TTL). Default false — always fetch fresh. Prefer cacheMaxAge when you need 1d–30d freshness control."
    },
    "cacheMaxAge": {
      "type": "string",
      "description": "Max age of a cached response: 1d, 3d, 7d, 14d, or 30d. When set, enables caching with that TTL."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "url"
  ],
  "properties": {
    "url": {
      "type": "string",
      "format": "uri",
      "description": "LinkedIn Ad Library URL or numeric ad ID (also accepts urn:li:sponsoredCreative:ID). Inputs that are neither numeric nor an ad-library detail URL are a definitive 400. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble."
    },
    "cache": {
      "type": "boolean",
      "description": "Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "url"
  ],
  "properties": {
    "url": {
      "type": "string",
      "format": "uri",
      "description": "LinkedIn company URL, e.g. https://www.linkedin.com/company/shopify. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble."
    },
    "cache": {
      "type": "boolean",
      "description": "Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "url"
  ],
  "properties": {
    "url": {
      "type": "string",
      "format": "uri",
      "description": "LinkedIn company URL, e.g. https://linkedin.com/company/slug. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble."
    },
    "cache": {
      "type": "boolean",
      "description": "Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "description": "Max items to return (default 20, max 100). Only the ~10 posts the public page shows are available. Flat 1 credit."
    },
    "cursor": {
      "type": "string",
      "description": "Pagination cursor. Leave empty for the first page; then pass the nextCursor value returned in the previous response (numeric offset, e.g. 5). A null nextCursor means the end of the list. Only the recent posts LinkedIn shows logged-out visitors (about 10) are available."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "url"
  ],
  "properties": {
    "url": {
      "type": "string",
      "format": "uri",
      "description": "LinkedIn post or activity URL. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble."
    },
    "cache": {
      "type": "boolean",
      "description": "Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "url"
  ],
  "properties": {
    "url": {
      "type": "string",
      "format": "uri",
      "description": "LinkedIn post or activity URL. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble."
    },
    "cache": {
      "type": "boolean",
      "description": "Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "url"
  ],
  "properties": {
    "url": {
      "type": "string",
      "format": "uri",
      "description": "LinkedIn profile URL, e.g. https://www.linkedin.com/in/paul-martin-a5aa98. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble."
    },
    "cache": {
      "type": "boolean",
      "description": "Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "q"
  ],
  "properties": {
    "q": {
      "type": "string",
      "description": "Search query or keywords (min 2 characters)."
    },
    "sort": {
      "type": "string",
      "description": "relevance (default, search-engine rank — dates can span years) or date (found posts newest first)."
    },
    "cache": {
      "type": "boolean",
      "description": "Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "description": "Max items to return (default 20, max 50). Billed per result."
    },
    "cursor": {
      "type": "string",
      "description": "Pagination cursor. Leave empty for the first page; then pass the nextCursor value returned in the previous response (numeric offset, e.g. 20). A null nextCursor means the end of the list (max 50 posts)."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "url"
  ],
  "properties": {
    "url": {
      "type": "string",
      "format": "uri",
      "description": "Linkme profile URL or username, e.g. https://link.me/danucd or danucd. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble."
    },
    "cache": {
      "type": "boolean",
      "description": "Set true to serve from the response cache (default TTL). Default false — always fetch fresh. Prefer cacheMaxAge when you need 1d–30d freshness control."
    },
    "cacheMaxAge": {
      "type": "string",
      "description": "Max age of a cached response: 1d, 3d, 7d, 14d, or 30d. When set, enables caching with that TTL."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "url"
  ],
  "properties": {
    "url": {
      "type": "string",
      "format": "uri",
      "description": "Linktree profile URL or username. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble."
    },
    "cache": {
      "type": "boolean",
      "description": "Set true to serve from the response cache (default TTL). Default false — always fetch fresh. Prefer cacheMaxAge when you need 1d–30d freshness control."
    },
    "cacheMaxAge": {
      "type": "string",
      "description": "Max age of a cached response: 1d, 3d, 7d, 14d, or 30d. When set, enables caching with that TTL."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "url"
  ],
  "properties": {
    "url": {
      "type": "string",
      "format": "uri",
      "description": "Pillar page URL or username. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble."
    },
    "cache": {
      "type": "boolean",
      "description": "Set true to serve from the response cache (default TTL). Default false — always fetch fresh. Prefer cacheMaxAge when you need 1d–30d freshness control."
    },
    "cacheMaxAge": {
      "type": "string",
      "description": "Max age of a cached response: 1d, 3d, 7d, 14d, or 30d. When set, enables caching with that TTL."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "url"
  ],
  "properties": {
    "url": {
      "type": "string",
      "format": "uri",
      "description": "Pinterest board URL (.../username/board-name/), not a /pin/ URL. Example: https://www.pinterest.com/potterybarn/rustic-lodge-lookbook/. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble."
    },
    "cache": {
      "type": "boolean",
      "description": "Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "description": "Max items to return (default 25, max 200). Billed per result."
    },
    "cursor": {
      "type": "string",
      "description": "Pagination cursor. Leave empty for the first page; then pass the nextCursor value returned in the previous response (numeric offset, e.g. 25). A null nextCursor means the end of the retrievable window (pidgets ~100)."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "url"
  ],
  "properties": {
    "url": {
      "type": "string",
      "format": "uri",
      "description": "Pinterest pin URL, e.g. https://pinterest.com/pin/ID/. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble."
    },
    "cache": {
      "type": "boolean",
      "description": "Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "q"
  ],
  "properties": {
    "q": {
      "type": "string",
      "description": "Keywords or search query (min 2 characters)."
    },
    "cache": {
      "type": "boolean",
      "description": "Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "description": "Max items to return (default 25, max 200). Billed per result."
    },
    "cursor": {
      "type": "string",
      "description": "Pagination cursor. Leave empty for the first page; then pass the nextCursor value returned in the previous response (numeric offset, e.g. 25). A null nextCursor means the end of the SERP window (max 40)."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "url"
  ],
  "properties": {
    "url": {
      "type": "string",
      "format": "uri",
      "description": "Pinterest profile URL or username. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble."
    },
    "cache": {
      "type": "boolean",
      "description": "Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "description": "Max items to return (default 25, max 200). Billed per result."
    },
    "cursor": {
      "type": "string",
      "description": "Pagination cursor. Leave empty for the first page; then pass the nextCursor value returned in the previous response (numeric offset, e.g. 25). A null nextCursor means the end of the retrievable window (max 200)."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "url"
  ],
  "properties": {
    "url": {
      "type": "string",
      "format": "uri",
      "description": "Pinterest profile URL or username. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble."
    },
    "cache": {
      "type": "boolean",
      "description": "Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "description": "Max items to return (default 25, max 200). Billed per result."
    },
    "cursor": {
      "type": "string",
      "description": "Pagination cursor. Leave empty for the first page; then pass the nextCursor value returned in the previous response (numeric offset, e.g. 25). A null nextCursor means the end of the retrievable window (pidgets ~100)."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "url"
  ],
  "properties": {
    "url": {
      "type": "string",
      "format": "uri",
      "description": "Reddit post URL. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble."
    },
    "cache": {
      "type": "boolean",
      "description": "Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "description": "Max items to return (default 50, max 500). Flat 2 credits per call."
    },
    "cursor": {
      "type": "string",
      "description": "Pagination cursor. Leave empty for the first page; then pass the nextCursor value returned in the previous response."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "url"
  ],
  "properties": {
    "url": {
      "type": "string",
      "format": "uri",
      "description": "Reddit post URL, e.g. https://reddit.com/r/sub/comments/ID/... The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble."
    },
    "cache": {
      "type": "boolean",
      "description": "Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "url"
  ],
  "properties": {
    "url": {
      "type": "string",
      "format": "uri",
      "description": "Reddit post URL. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble."
    },
    "cache": {
      "type": "boolean",
      "description": "Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "description": "Max items to return (default 50, max 200). Flat 2 credits per call."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "q"
  ],
  "properties": {
    "q": {
      "type": "string",
      "description": "Keyword or phrase to search Reddit posts site-wide (min 2 characters)."
    },
    "sort": {
      "type": "string",
      "description": "relevance (default) | new | top | hot | comments (alias: comment_count)."
    },
    "cache": {
      "type": "boolean",
      "description": "Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "description": "Max items to return (default 25, max 200). Flat 2 credits per call."
    },
    "cursor": {
      "type": "string",
      "description": "Pagination cursor. Leave empty for the first page; then pass the nextCursor value returned in the previous response."
    },
    "timeframe": {
      "type": "string",
      "description": "For sort=top or comments: hour | day | week | month | year | all (default all)."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "url"
  ],
  "properties": {
    "url": {
      "type": "string",
      "format": "uri",
      "description": "Subreddit URL, r/name, or bare name (case-insensitive), e.g. r/technology or AskReddit. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble."
    },
    "cache": {
      "type": "boolean",
      "description": "Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "url"
  ],
  "properties": {
    "url": {
      "type": "string",
      "format": "uri",
      "description": "Subreddit URL, r/name, or bare name, e.g. r/technology. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble."
    },
    "sort": {
      "type": "string",
      "description": "Feed sort: best, hot, new (default), top, or rising."
    },
    "cache": {
      "type": "boolean",
      "description": "Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "description": "Max items to return (default 25, max 200). Flat 2 credits per call."
    },
    "cursor": {
      "type": "string",
      "description": "Pagination cursor. Leave empty for the first page; then pass the nextCursor value returned in the previous response."
    },
    "timeframe": {
      "type": "string",
      "description": "For sort=top: hour, day (default), week, month, year, or all."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "url"
  ],
  "properties": {
    "url": {
      "type": "string",
      "format": "uri",
      "description": "Rumble channel URL, e.g. https://rumble.com/c/name. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble."
    },
    "cache": {
      "type": "boolean",
      "description": "Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "description": "Max items to return (default 20, max 200). Billed per result."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "url"
  ],
  "properties": {
    "url": {
      "type": "string",
      "format": "uri",
      "description": "Rumble video URL, e.g. https://rumble.com/vXXXX-title.html. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble."
    },
    "cache": {
      "type": "boolean",
      "description": "Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "description": "Max items to return (default 50, max 500). Flat 2 credits per call."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "q"
  ],
  "properties": {
    "q": {
      "type": "string",
      "description": "Keywords or search query (min 2 characters)."
    },
    "cache": {
      "type": "boolean",
      "description": "Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "description": "Max items to return (default 20, max 200). Billed per result."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "url"
  ],
  "properties": {
    "url": {
      "type": "string",
      "format": "uri",
      "description": "Rumble video URL, e.g. https://rumble.com/vXXXX-title.html. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble."
    },
    "cache": {
      "type": "boolean",
      "description": "Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "url"
  ],
  "properties": {
    "url": {
      "type": "string",
      "format": "uri",
      "description": "Rumble video URL, e.g. https://rumble.com/vXXXX-title.html. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble."
    },
    "cache": {
      "type": "boolean",
      "description": "Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh."
    },
    "language": {
      "type": "string",
      "description": "Preferred caption language as an ISO code, e.g. \"en\". Defaults to auto-detect."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "url"
  ],
  "properties": {
    "url": {
      "type": "string",
      "format": "uri",
      "description": "Snapchat username or profile URL. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble."
    },
    "cache": {
      "type": "boolean",
      "description": "Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "url"
  ],
  "properties": {
    "url": {
      "type": "string",
      "format": "uri",
      "description": "SoundCloud artist profile URL or username. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble."
    },
    "cache": {
      "type": "boolean",
      "description": "Set true to serve from the response cache (default TTL). Default false — always fetch fresh. Prefer cacheMaxAge when you need 1d–30d freshness control."
    },
    "cacheMaxAge": {
      "type": "string",
      "description": "Max age of a cached response: 1d, 3d, 7d, 14d, or 30d. When set, enables caching with that TTL."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "url"
  ],
  "properties": {
    "url": {
      "type": "string",
      "format": "uri",
      "description": "SoundCloud artist profile URL or username. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble."
    },
    "cache": {
      "type": "boolean",
      "description": "Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "description": "Max items to return (default 20, max 100). Flat 2 credits per call."
    },
    "cursor": {
      "type": "string",
      "description": "Opaque pagination cursor from the previous nextCursor. Leave empty for the first page. Do not edit or invent values."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "url"
  ],
  "properties": {
    "url": {
      "type": "string",
      "format": "uri",
      "description": "SoundCloud track URL. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble."
    },
    "cache": {
      "type": "boolean",
      "description": "Set true to serve from the response cache (default TTL). Default false — always fetch fresh. Prefer cacheMaxAge when you need 1d–30d freshness control."
    },
    "cacheMaxAge": {
      "type": "string",
      "description": "Max age of a cached response: 1d, 3d, 7d, 14d, or 30d. When set, enables caching with that TTL."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "url"
  ],
  "properties": {
    "raw": {
      "type": "boolean",
      "description": "Include the upstream GraphQL payload as data.raw. Default false — omit unless you need fields not in the normalized shape."
    },
    "url": {
      "type": "string",
      "format": "uri",
      "description": "Spotify URL, URI, or ID. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble."
    },
    "cache": {
      "type": "boolean",
      "description": "Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "url"
  ],
  "properties": {
    "raw": {
      "type": "boolean",
      "description": "Include the upstream GraphQL payload as data.raw. Default false — omit unless you need fields not in the normalized shape (~80% of the old response body)."
    },
    "url": {
      "type": "string",
      "format": "uri",
      "description": "Spotify URL, URI, or ID. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble."
    },
    "cache": {
      "type": "boolean",
      "description": "Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "url"
  ],
  "properties": {
    "url": {
      "type": "string",
      "format": "uri",
      "description": "Spotify show/podcast URL, URI, or ID (e.g. https://open.spotify.com/show/…). Not an artist URL."
    },
    "cache": {
      "type": "boolean",
      "description": "Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "url"
  ],
  "properties": {
    "raw": {
      "type": "boolean",
      "description": "Include slimmed per-episode upstream payload as episodes[].raw. Default false. visualIdentity / playedState / podcastV2 are never included."
    },
    "url": {
      "type": "string",
      "format": "uri",
      "description": "Spotify show/podcast URL, URI, or ID (e.g. https://open.spotify.com/show/…). Not an artist URL."
    },
    "cache": {
      "type": "boolean",
      "description": "Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "description": "Max items to return (default 20, max 50). Flat 2 credits per call."
    },
    "cursor": {
      "type": "string",
      "description": "Pagination cursor. Leave empty for the first page; then pass the nextCursor value returned in the previous response."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "q"
  ],
  "properties": {
    "q": {
      "type": "string",
      "description": "Search term (min 2 chars)."
    },
    "raw": {
      "type": "boolean",
      "description": "Include per-result upstream payload as results[].raw. Default false. Pathfinder GraphQL vs fallback-path shapes differ — see FAQ."
    },
    "type": {
      "type": "string",
      "description": "Result kind: tracks (default), albums, artists, podcasts, or episodes."
    },
    "cache": {
      "type": "boolean",
      "description": "Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "description": "Max items to return (default 20, max 50). Flat 2 credits per call."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "url"
  ],
  "properties": {
    "raw": {
      "type": "boolean",
      "description": "Include the upstream GraphQL payload as data.raw. Default false — getTrack embeds bulky artist discography."
    },
    "url": {
      "type": "string",
      "format": "uri",
      "description": "Spotify URL, URI, or ID. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble."
    },
    "cache": {
      "type": "boolean",
      "description": "Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "url"
  ],
  "properties": {
    "url": {
      "type": "string",
      "format": "uri",
      "description": "Threads post URL, e.g. https://threads.net/@user/post/CODE. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble."
    },
    "cache": {
      "type": "boolean",
      "description": "Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "url"
  ],
  "properties": {
    "url": {
      "type": "string",
      "format": "uri",
      "description": "Threads profile URL or @handle, e.g. https://threads.net/@username. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble."
    },
    "cache": {
      "type": "boolean",
      "description": "Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "q"
  ],
  "properties": {
    "q": {
      "type": "string",
      "description": "Keyword or phrase to search public Threads posts (min 2 characters)."
    },
    "cache": {
      "type": "boolean",
      "description": "Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "description": "Max items to return (default 25, max 200). Flat 2 credits per call."
    },
    "orderBy": {
      "type": "string",
      "description": "Sort the fetched page: relevant (default, Meta Top / similar to query), post_dated (newest publishedAt first), or engagement (likes+replies+reposts+quotes+views). Unknown values are 400."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "q"
  ],
  "properties": {
    "q": {
      "type": "string",
      "description": "Keyword to find Threads users / creators (min 2 characters)."
    },
    "cache": {
      "type": "boolean",
      "description": "Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "description": "Max items to return (default 20, max 100). Flat 1 credit per call."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "url"
  ],
  "properties": {
    "url": {
      "type": "string",
      "format": "uri",
      "description": "Threads profile URL or @handle. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble."
    },
    "cache": {
      "type": "boolean",
      "description": "Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "description": "Max items to return (default 20, max 100). Threads exposes only a short window of recent public posts on this surface. limit caps what you receive; it cannot increase what Threads returns. Flat 2 credits on every successful path (native and extended)."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "url"
  ],
  "properties": {
    "url": {
      "type": "string",
      "format": "uri",
      "description": "TikTok Ad Library URL or numeric ad ID. Inputs with no extractable numeric ID are a definitive 400. An ID TikTok's library positively reports as nonexistent is a definitive 404 AD_NOT_FOUND (ads outside the EU/EEA+UK+CH never enter the library, and entries expire one year after last impression). The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble."
    },
    "cache": {
      "type": "boolean",
      "description": "Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh."
    },
    "country": {
      "type": "string",
      "description": "Two-letter ISO country code. Default GB. Only EU/EEA + UK + CH are covered by TikTok's library; other codes return 400 UNSUPPORTED_REGION."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "q"
  ],
  "properties": {
    "q": {
      "type": "string",
      "description": "Keyword or advertiser to search TikTok Commercial Content Library (min 2 characters)."
    },
    "cache": {
      "type": "boolean",
      "description": "Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "description": "Max items to return (default 20, max 200). Does not change the price: 2 credits native, 5 via the fallback path, 0 when empty."
    },
    "match": {
      "type": "string",
      "description": "Keyword token mode: \"any\" (default, OR whole-word) or \"all\" (AND). hair ≠ wheelchair. Literal hits lead; already-fetched SERP ads fill behind them up to limit (matchedFrom [] = ranked fill). Empty results are free."
    },
    "country": {
      "type": "string",
      "description": "Two-letter ISO country code (e.g. GB, DE, FR). Default GB. TikTok's Commercial Content Library only covers the EU/EEA, the UK and Switzerland (32 countries) — other codes (US, SA, …) return 400 UNSUPPORTED_REGION with the supported list; TikTok has no ad-library data for them."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "url"
  ],
  "properties": {
    "url": {
      "type": "string",
      "format": "uri",
      "description": "TikTok profile URL, @handle, or username, e.g. https://tiktok.com/@username. Not a YouTube channel URL. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble."
    },
    "cache": {
      "type": "boolean",
      "description": "Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh."
    },
    "videos": {
      "type": "integer",
      "minimum": 1,
      "description": "How many recent videos to sample comments from: 12 (default, 3 credits), 30 (5 credits), or 60 (8 credits)."
    },
    "countriesLimit": {
      "type": "integer",
      "minimum": 1,
      "description": "Max countries in audienceLocations; remainder folds into other{count,percentage}. Omit for the full list (other is omitted when unused)."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "url"
  ],
  "properties": {
    "raw": {
      "type": "boolean",
      "description": "Set true to include TikTok's upstream user/statsV2 blob under raw, plus createTimeUnix (unix twin of createTime). Default false — curated fields only."
    },
    "url": {
      "type": "string",
      "format": "uri",
      "description": "TikTok profile URL, @handle, or username, e.g. https://tiktok.com/@username. Not a YouTube channel URL. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble."
    },
    "cache": {
      "type": "boolean",
      "description": "Set true to serve from the response cache (default TTL). Default false — always fetch fresh. Prefer cacheMaxAge when you need 1d–30d freshness control."
    },
    "cacheMaxAge": {
      "type": "string",
      "description": "Max age of a cached response: 1d, 3d, 7d, 14d, or 30d. When set, enables caching with that TTL."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "url"
  ],
  "properties": {
    "url": {
      "type": "string",
      "format": "uri",
      "description": "TikTok profile URL, @handle, or username, e.g. https://tiktok.com/@username. Not a YouTube channel URL. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble."
    },
    "cache": {
      "type": "boolean",
      "description": "Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "description": "How many of the creator's latest videos to return on this page (default 20, max 200). Newest first. Flat 2 credits per successful call."
    },
    "cursor": {
      "type": "string",
      "description": "Pagination cursor. Leave empty for the first page; then pass the nextCursor value returned in the previous response (TikTok's max_cursor timestamp, e.g. 1783614676000). A null nextCursor means the end of the list."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "url",
    "commentId"
  ],
  "properties": {
    "url": {
      "type": "string",
      "format": "uri",
      "description": "Public TikTok video URL, e.g. https://www.tiktok.com/@khaby.lame/video/7646812028874673439. Not a YouTube/Instagram/Facebook URL. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble."
    },
    "cache": {
      "type": "boolean",
      "description": "Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "description": "Max items to return (default 50, max 500). Flat 2 credits per call."
    },
    "cursor": {
      "type": "string",
      "description": "Pagination cursor. Leave empty for the first page; then pass the nextCursor value from the previous response."
    },
    "commentId": {
      "type": "string",
      "description": "ID of the parent (top-level) comment to fetch replies for — from the comments endpoint. Legacy alias: comment_id."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "url"
  ],
  "properties": {
    "url": {
      "type": "string",
      "format": "uri",
      "description": "Public TikTok video URL, e.g. https://www.tiktok.com/@khaby.lame/video/7646812028874673439. Not a YouTube/Instagram/Facebook URL. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble."
    },
    "cache": {
      "type": "boolean",
      "description": "Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "description": "Max items to return (default 50, max 500). Flat 2 credits per call."
    },
    "cursor": {
      "type": "string",
      "description": "Pagination cursor. Leave empty for the first page; then pass the nextCursor value returned in the previous response (a numeric offset, e.g. 50). A null nextCursor means the end of the comments."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "url"
  ],
  "properties": {
    "url": {
      "type": "string",
      "format": "uri",
      "description": "TikTok profile URL, @handle, or username, e.g. https://tiktok.com/@username. Not a YouTube channel URL. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble."
    },
    "cache": {
      "type": "boolean",
      "description": "Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "url"
  ],
  "properties": {
    "url": {
      "type": "string",
      "format": "uri",
      "description": "TikTok profile URL, @handle, or username, e.g. https://tiktok.com/@username. Not a YouTube channel URL. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble."
    },
    "cache": {
      "type": "boolean",
      "description": "Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "url"
  ],
  "properties": {
    "url": {
      "type": "string",
      "format": "uri",
      "description": "TikTok music/sound URL, e.g. https://tiktok.com/music/name-ID. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble."
    },
    "cache": {
      "type": "boolean",
      "description": "Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "description": "Most videos to return (default 20, 1–50; outside that range is a 400). TikTok serves this feed in short pages, so a call can return fewer than limit with a nextCursor to continue. Flat 2 credits per call."
    },
    "cursor": {
      "type": "string",
      "description": "Pagination cursor. Leave empty for the first page; then pass the nextCursor value returned in the previous response. hasMore is true only when nextCursor is present."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "page": {
      "type": "integer",
      "minimum": 1,
      "description": "Creative Center page (default 1)."
    },
    "sort": {
      "type": "string",
      "description": "follower, engagement, or popularity. Default follower."
    },
    "cache": {
      "type": "boolean",
      "description": "Set true to serve from the response cache (default TTL). Default false — always fetch fresh. Prefer cacheMaxAge when you need 1d–30d freshness control."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "description": "Max items to return (default 20, max 100). Flat 2 credits per call."
    },
    "country": {
      "type": "string",
      "description": "Two-letter ISO country code. Default US."
    },
    "cacheMaxAge": {
      "type": "string",
      "description": "Max age of a cached response: 1d, 3d, 7d, 14d, or 30d. When set, enables caching with that TTL."
    },
    "follower_count": {
      "type": "string",
      "description": "Optional range on the For You ranking: 10k-100k, 100k-1m, 1m-10m, >10m."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "url"
  ],
  "properties": {
    "raw": {
      "type": "boolean",
      "description": "Set true to include TikTok's upstream user/statsV2 blob under raw. Default false — curated fields only."
    },
    "url": {
      "type": "string",
      "format": "uri",
      "description": "TikTok profile URL, @handle, or username, e.g. https://tiktok.com/@username. Not a YouTube channel URL. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble."
    },
    "cache": {
      "type": "boolean",
      "description": "Set true to serve from the 7d response cache (0 credits on hit). Default false — always fetch fresh. Prefer cacheMaxAge when you need 1d–30d freshness control."
    },
    "cacheMaxAge": {
      "type": "string",
      "description": "Max age of a cached response: 1d, 3d, 7d, 14d, or 30d. When set, enables caching with that TTL."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "q"
  ],
  "properties": {
    "q": {
      "type": "string",
      "description": "Single hashtag token for the /tag/{name} challenge feed, with or without # (min 2). Spaces are 400 — use /v1/tiktok/top-search for a keyword query."
    },
    "cache": {
      "type": "boolean",
      "description": "Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "description": "Max items to return (default 20, max 100). Billed per result."
    },
    "cursor": {
      "type": "integer",
      "minimum": 1,
      "description": "Pagination offset. Leave at 0 (or omit) for the first page; then pass the nextCursor value returned in the previous response. A null nextCursor means the end of the results."
    },
    "region": {
      "type": "string",
      "description": "Two-letter ISO 3166-1 country code. Default US. Accepted for compatibility; does not filter results by country."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "q"
  ],
  "properties": {
    "q": {
      "type": "string",
      "description": "Seed keyword to expand into autocomplete suggestions, e.g. skincare."
    },
    "cache": {
      "type": "boolean",
      "description": "Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "description": "Max items to return (default 20, max 100). Flat 2 credits per call."
    },
    "country": {
      "type": "string",
      "description": "Two-letter ISO country code that localizes the suggestions to a market, e.g. US, GB, DE. Default US."
    },
    "language": {
      "type": "string",
      "description": "Interface language for the suggestions, e.g. en-US or de-DE. Default en-US."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "q"
  ],
  "properties": {
    "q": {
      "type": "string",
      "description": "Search query matched against usernames, display names and bios (min 2 characters)."
    },
    "cache": {
      "type": "boolean",
      "description": "Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "description": "Max items to return (default 20, max 100). Flat 1 credit per call."
    },
    "cursor": {
      "type": "string",
      "description": "Pagination cursor. Omit (or pass 0) for the first page; then pass the nextCursor value from the previous response verbatim — it carries the search session, not just an offset. A null nextCursor means the end of the results."
    },
    "fallback": {
      "type": "boolean",
      "description": "Deprecated — no effect, removed on 2026-12-17. Sending it adds an X-Captapi-Warning response header. When native search is unavailable the response is an empty degraded page (0 credits)."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "url"
  ],
  "properties": {
    "url": {
      "type": "string",
      "format": "uri",
      "description": "TikTok Shop product URL, e.g. https://shop.tiktok.com/view/product/1731410956394792439?region=BR or https://www.tiktok.com/shop/pdp/1731098552908944370. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble."
    },
    "cache": {
      "type": "boolean",
      "description": "Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh."
    },
    "region": {
      "type": "string",
      "description": "Two-letter market region (default US). A region= or oec_region= query on the product URL wins over this default so a BR share URL is not fetched as US. Echoed as data.region."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "url"
  ],
  "properties": {
    "url": {
      "type": "string",
      "format": "uri",
      "description": "TikTok Shop product URL, e.g. https://www.tiktok.com/shop/pdp/1731962298839634826. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble."
    },
    "cache": {
      "type": "boolean",
      "description": "Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "description": "Max items to return (default 20, max 200). Billed per result."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "url"
  ],
  "properties": {
    "url": {
      "type": "string",
      "format": "uri",
      "description": "TikTok Shop store URL with numeric shop id, e.g. https://www.tiktok.com/shop/store/goli-nutrition/7495794203056835079. A slug-only /shop/store/{name} URL is a definitive 400 — TikTok's catalog SSR is keyed by shop id. Get the full URL from /v1/tiktok-shop/user-showcase or a product's seller.url. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble."
    },
    "cache": {
      "type": "boolean",
      "description": "Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "description": "Max items to return (default 20, max 200). 2 credits when served natively (limit ≤ 30); above 30, or when the native page misses, the fallback path bills 2.8 credits per product returned, rounded up, minimum 2."
    },
    "region": {
      "type": "string",
      "description": "Two-letter market region (default US). Non-US coverage depends on TikTok exposing that shop in the selected region — empty results outside the US are often a platform limit, not a Captapi bug."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "q"
  ],
  "properties": {
    "q": {
      "type": "string",
      "description": "Product search query (min 2 characters), e.g. phone case."
    },
    "cache": {
      "type": "boolean",
      "description": "Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "description": "Max items to return (default 10, max 10). Flat 2 credits per call."
    },
    "region": {
      "type": "string",
      "description": "Two-letter market region for the search (default US). Echoed on the response as data.region — not a creator home country. Native search is a SERP window (not TikTok's full catalog); compare requested to serpHits / windowMax."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "username"
  ],
  "properties": {
    "cache": {
      "type": "boolean",
      "description": "Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "description": "Max items to return (default 20, max 200). Billed per result."
    },
    "username": {
      "type": "string",
      "description": "TikTok username, @handle, or profile URL, e.g. jeffreestar or https://www.tiktok.com/@jeffreestar."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "url"
  ],
  "properties": {
    "url": {
      "type": "string",
      "format": "uri",
      "description": "TikTok music/sound URL, e.g. https://tiktok.com/music/name-ID. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble."
    },
    "cache": {
      "type": "boolean",
      "description": "Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "url"
  ],
  "properties": {
    "url": {
      "type": "string",
      "format": "uri",
      "description": "Public TikTok video URL, e.g. https://www.tiktok.com/@khaby.lame/video/7646812028874673439. Not a YouTube/Instagram/Facebook URL. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble."
    },
    "cache": {
      "type": "boolean",
      "description": "Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh."
    },
    "language": {
      "type": "string",
      "description": "ISO code, e.g. \"tr\": pins the speech language and sets the summary output language. Defaults to auto-detect + English summary."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "q"
  ],
  "properties": {
    "q": {
      "type": "string",
      "description": "Search query or keywords (min 2 characters)."
    },
    "cache": {
      "type": "boolean",
      "description": "Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "description": "Max items to return (default 20, max 200). Flat 2 credits per call."
    },
    "cursor": {
      "type": "integer",
      "minimum": 1,
      "description": "Pagination cursor. Leave 0 for the first page; then pass nextCursor from the previous response. TikTok may return duplicates across pages."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "url"
  ],
  "properties": {
    "url": {
      "type": "string",
      "format": "uri",
      "description": "Public TikTok video URL, e.g. https://www.tiktok.com/@khaby.lame/video/7646812028874673439. Not a YouTube/Instagram/Facebook URL. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble."
    },
    "cache": {
      "type": "boolean",
      "description": "Serve from the 24h shared cache when available (0 credits on hit). Default true — set false to always fetch fresh."
    },
    "language": {
      "type": "string",
      "description": "Preferred caption language as an ISO code, e.g. \"en\". Defaults to auto-detect."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "url"
  ],
  "properties": {
    "url": {
      "type": "string",
      "format": "uri",
      "description": "TikTok profile URL, @handle, or username, e.g. https://tiktok.com/@username. Not a YouTube channel URL. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble."
    },
    "cache": {
      "type": "boolean",
      "description": "Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "description": "Max items to return (default 50, max 500). Flat 1 credit per call."
    },
    "cursor": {
      "type": "string",
      "description": "Pagination cursor (TikTok minCursor). Leave empty for the first page; then pass nextCursor from the previous response."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "url"
  ],
  "properties": {
    "url": {
      "type": "string",
      "format": "uri",
      "description": "TikTok profile URL, @handle, or username, e.g. https://tiktok.com/@username. Not a YouTube channel URL. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble."
    },
    "cache": {
      "type": "boolean",
      "description": "Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "description": "Max items to return (default 50, max 500). Flat 1 credit per call."
    },
    "cursor": {
      "type": "string",
      "description": "Pagination cursor (TikTok minCursor). Leave empty for the first page; then pass nextCursor from the previous response."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "url"
  ],
  "properties": {
    "url": {
      "type": "string",
      "format": "uri",
      "description": "Public TikTok video URL, e.g. https://www.tiktok.com/@khaby.lame/video/7646812028874673439. Not a YouTube/Instagram/Facebook URL. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble."
    },
    "cache": {
      "type": "boolean",
      "description": "Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "url"
  ],
  "properties": {
    "url": {
      "type": "string",
      "format": "uri",
      "description": "Truth Social post URL or post ID. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble."
    },
    "cache": {
      "type": "boolean",
      "description": "Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "url"
  ],
  "properties": {
    "url": {
      "type": "string",
      "format": "uri",
      "description": "Truth Social profile URL or @username. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble."
    },
    "cache": {
      "type": "boolean",
      "description": "Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "url"
  ],
  "properties": {
    "url": {
      "type": "string",
      "format": "uri",
      "description": "Truth Social profile URL or @username. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble."
    },
    "cache": {
      "type": "boolean",
      "description": "Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "description": "Max posts to return (default 20, max 80). Truth Social's statuses page is ~20 items — a full page returns nextCursor. On the extended path hasMore can be true with nextCursor null (truncatedReason=single_page_only). Flat 2 credits."
    },
    "cursor": {
      "type": "string",
      "description": "Pagination cursor. Leave empty for the first page; then pass the nextCursor value returned in the previous response."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "url"
  ],
  "properties": {
    "url": {
      "type": "string",
      "format": "uri",
      "description": "Twitch clip URL (clips.twitch.tv/<slug> or twitch.tv/<channel>/clip/<slug>). The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble."
    },
    "cache": {
      "type": "boolean",
      "description": "Set true to serve from the response cache (default TTL). Default false — always fetch fresh. Prefer cacheMaxAge when you need 1d–30d freshness control."
    },
    "cacheMaxAge": {
      "type": "string",
      "description": "Max age of a cached response: 1d, 3d, 7d, 14d, or 30d. When set, enables caching with that TTL."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "url"
  ],
  "properties": {
    "url": {
      "type": "string",
      "format": "uri",
      "description": "Twitch channel URL or username, e.g. https://www.twitch.tv/shroud. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble."
    },
    "cache": {
      "type": "boolean",
      "description": "Set true to serve from the response cache (default TTL). Default false — always fetch fresh. Prefer cacheMaxAge when you need 1d–30d freshness control."
    },
    "cacheMaxAge": {
      "type": "string",
      "description": "Max age of a cached response: 1d, 3d, 7d, 14d, or 30d. When set, enables caching with that TTL."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "url"
  ],
  "properties": {
    "url": {
      "type": "string",
      "format": "uri",
      "description": "Twitch channel URL or username, e.g. https://www.twitch.tv/shroud. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble."
    },
    "cache": {
      "type": "boolean",
      "description": "Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "description": "Max schedule segments to return (default 50, max 100). Flat 1 credit per call."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "url"
  ],
  "properties": {
    "url": {
      "type": "string",
      "format": "uri",
      "description": "Twitch channel URL or username, e.g. https://www.twitch.tv/shroud. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble."
    },
    "cache": {
      "type": "boolean",
      "description": "Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "description": "Max items to return (default 20, max 100). Flat 2 credits per call. Hard ceiling: first 100 matching videos only — deeper history is not available (windowMax=100)."
    },
    "cursor": {
      "type": "string",
      "description": "Pagination cursor = last video id from the previous nextCursor. Leave empty for the first page. Pages the first 100 matching videos only (not a raw offset)."
    },
    "sortBy": {
      "type": "string",
      "description": "TIME (default, newest first) or VIEWS."
    },
    "filterBy": {
      "type": "string",
      "description": "ARCHIVE | HIGHLIGHT | UPLOAD. Omit for all types — there is no default filter (unset filterBy is omitted, not null)."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "url"
  ],
  "properties": {
    "url": {
      "type": "string",
      "format": "uri",
      "description": "X community URL (x.com/i/communities/ID) or community ID — not a tweet/status URL. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble."
    },
    "cache": {
      "type": "boolean",
      "description": "Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "url"
  ],
  "properties": {
    "url": {
      "type": "string",
      "format": "uri",
      "description": "X community URL (x.com/i/communities/ID) or community ID — not a tweet/status URL. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble."
    },
    "cache": {
      "type": "boolean",
      "description": "Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "description": "Max items to return (default 25, max 200). Flat 2 credits per call."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "url"
  ],
  "properties": {
    "url": {
      "type": "string",
      "format": "uri",
      "description": "Twitter/X profile URL or @handle, e.g. https://x.com/username. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble."
    },
    "cache": {
      "type": "boolean",
      "description": "Set true to use the 1-hour profile cache (0 credits on hit). Default false — always fetch fresh. Prefer cacheMaxAge for 1d–30d."
    },
    "cacheMaxAge": {
      "type": "string",
      "description": "Max age of a cached response: 1d, 3d, 7d, 14d, or 30d. When set, enables caching with that TTL."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "url"
  ],
  "properties": {
    "url": {
      "type": "string",
      "format": "uri",
      "description": "Public tweet URL, e.g. https://x.com/user/status/ID. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble."
    },
    "cache": {
      "type": "boolean",
      "description": "Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "url"
  ],
  "properties": {
    "url": {
      "type": "string",
      "format": "uri",
      "description": "Public tweet URL, e.g. https://x.com/user/status/ID. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble."
    },
    "cache": {
      "type": "boolean",
      "description": "Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "url"
  ],
  "properties": {
    "url": {
      "type": "string",
      "format": "uri",
      "description": "Twitter/X profile URL or @handle. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble."
    },
    "cache": {
      "type": "boolean",
      "description": "Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "description": "Max tweets to return (default 20, max 200). Twitter's public surface usually caps around ~100 most popular posts — not chronological latest. Flat 2 credits per call."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "file"
  ],
  "properties": {
    "file": {
      "type": "string",
      "description": "Video or audio file (multipart form field — use -F file=@path, not a query string). Max 200MB / 60 minutes."
    },
    "language": {
      "type": "string",
      "description": "ISO-639-1 language hint, e.g. \"en\" or \"tr\". Omit to auto-detect."
    },
    "translate": {
      "type": "boolean",
      "description": "When true, translate speech to English before summarizing. Default false."
    },
    "timestampGranularity": {
      "type": "string",
      "description": "segment (default) or word."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "file"
  ],
  "properties": {
    "file": {
      "type": "string",
      "description": "Video or audio file (multipart form field — use -F file=@path, not a query string). Max 200MB / 60 minutes."
    },
    "language": {
      "type": "string",
      "description": "ISO-639-1 language hint, e.g. \"en\" or \"tr\". Omit to auto-detect."
    },
    "translate": {
      "type": "boolean",
      "description": "When true, translate speech to English. Default false."
    },
    "timestampGranularity": {
      "type": "string",
      "description": "segment (default) or word — word-level timings when the transcription model exposes them."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "url"
  ],
  "properties": {
    "url": {
      "type": "string",
      "format": "uri",
      "description": "Public YouTube video URL, e.g. https://youtube.com/watch?v=ID. Not a TikTok/Instagram/Facebook URL. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble."
    },
    "cache": {
      "type": "boolean",
      "description": "Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh."
    },
    "language": {
      "type": "string",
      "description": "Preferred caption language as an ISO code, e.g. \"en\". Defaults to auto-detect."
    },
    "maxCredits": {
      "type": "integer",
      "minimum": 1,
      "description": "Refuse before STT when estimatedCredits would exceed this (400 cost_exceeds_max, 0 credits). The estimate is on every success and, when the extract miss is retryable, as estimatedCreditsIfRetried."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "url"
  ],
  "properties": {
    "url": {
      "type": "string",
      "format": "uri",
      "description": "YouTube channel URL, @handle, bare handle, or UC... channel ID, e.g. https://youtube.com/@handle or @mkbhd. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble."
    },
    "cache": {
      "type": "boolean",
      "description": "Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "url"
  ],
  "properties": {
    "url": {
      "type": "string",
      "format": "uri",
      "description": "YouTube channel URL, @handle, bare handle, or UC... channel ID, e.g. https://youtube.com/@handle or @mkbhd. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble."
    },
    "cache": {
      "type": "boolean",
      "description": "Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "description": "Max items to return (default 20, max 200). Flat 2 credits per call."
    },
    "cursor": {
      "type": "string",
      "description": "Pagination cursor. Leave empty for the first page; then pass the nextCursor value returned in the previous response."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "url"
  ],
  "properties": {
    "url": {
      "type": "string",
      "format": "uri",
      "description": "YouTube channel URL, @handle, bare handle, or UC... channel ID, e.g. https://youtube.com/@handle or @mkbhd. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble."
    },
    "cache": {
      "type": "boolean",
      "description": "Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "description": "Max items to return (default 20, max 200). Flat 2 credits per call."
    },
    "cursor": {
      "type": "string",
      "description": "Pagination cursor. Leave empty for the first page; then pass the nextCursor value returned in the previous response."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "url"
  ],
  "properties": {
    "url": {
      "type": "string",
      "format": "uri",
      "description": "YouTube channel URL, @handle, bare handle, or UC... channel ID, e.g. https://youtube.com/@handle or @mkbhd. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble."
    },
    "cache": {
      "type": "boolean",
      "description": "Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "description": "Max items to return (default 20, max 200). Flat 2 credits when hasLiveTab is true; 0 credits when hasLiveTab is false."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "url"
  ],
  "properties": {
    "url": {
      "type": "string",
      "format": "uri",
      "description": "YouTube channel URL, @handle, bare handle, or UC... channel ID, e.g. https://youtube.com/@handle or @mkbhd. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble."
    },
    "fast": {
      "type": "boolean",
      "description": "Set true to use YouTube RSS for faster results with less detailed metadata. Leave false when viewCount/duration quality matters."
    },
    "cache": {
      "type": "boolean",
      "description": "Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "description": "Max items to return (default 20, max 200). Flat 2 credits per call."
    },
    "cursor": {
      "type": "string",
      "description": "Pagination cursor. Leave empty for the first page; then pass the nextCursor value returned in the previous response."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "url",
    "commentId"
  ],
  "properties": {
    "url": {
      "type": "string",
      "format": "uri",
      "description": "Public YouTube video URL, e.g. https://youtube.com/watch?v=ID. Not a TikTok/Instagram/Facebook URL. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble."
    },
    "cache": {
      "type": "boolean",
      "description": "Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "description": "Max items to return (default 50, max 500). Flat 2 credits per call."
    },
    "cursor": {
      "type": "string",
      "description": "Pagination cursor. Leave empty for the first page; then pass the nextCursor value returned in the previous response."
    },
    "commentId": {
      "type": "string",
      "description": "ID of the parent (top-level) comment to fetch replies for — from the comments endpoint. Legacy alias: comment_id."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "url"
  ],
  "properties": {
    "url": {
      "type": "string",
      "format": "uri",
      "description": "Public YouTube video URL, e.g. https://youtube.com/watch?v=ID. Not a TikTok/Instagram/Facebook URL. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble."
    },
    "cache": {
      "type": "boolean",
      "description": "Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "description": "Max items to return (default 50, max 500). Flat 2 credits per call."
    },
    "cursor": {
      "type": "string",
      "description": "Pagination cursor. Leave empty for the first page; then pass the nextCursor value returned in the previous response."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "url"
  ],
  "properties": {
    "url": {
      "type": "string",
      "format": "uri",
      "description": "YouTube community post URL (/post/Ugkx… or /community?lb=). Trailing whitespace is stripped. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble."
    },
    "cache": {
      "type": "boolean",
      "description": "Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "url"
  ],
  "properties": {
    "url": {
      "type": "string",
      "format": "uri",
      "description": "YouTube channel URL, @handle, bare handle, or UC... channel ID, e.g. https://youtube.com/@handle or @mkbhd. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble."
    },
    "cache": {
      "type": "boolean",
      "description": "Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "description": "Max items to return (default 20, max 200). Flat 1 credit per call."
    },
    "cursor": {
      "type": "string",
      "description": "Pagination cursor. Leave empty for the first page; then pass the nextCursor value returned in the previous response."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "q"
  ],
  "properties": {
    "q": {
      "type": "string",
      "description": "Hashtag with or without the # (min 2 characters). One token — spaces are 400 HASHTAG_HAS_SPACES."
    },
    "cache": {
      "type": "boolean",
      "description": "Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "description": "Max items to return (default 20, max 200). Returns a single window; use limit to size it. No cursor. Billed per result."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "url"
  ],
  "properties": {
    "url": {
      "type": "string",
      "format": "uri",
      "description": "YouTube playlist URL, e.g. https://youtube.com/playlist?list=ID. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble."
    },
    "cache": {
      "type": "boolean",
      "description": "Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "url"
  ],
  "properties": {
    "url": {
      "type": "string",
      "format": "uri",
      "description": "YouTube playlist URL, e.g. https://youtube.com/playlist?list=ID. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble."
    },
    "fast": {
      "type": "boolean",
      "description": "Set true to use YouTube RSS for faster results with less detailed metadata. Leave false when viewCount/duration quality matters."
    },
    "cache": {
      "type": "boolean",
      "description": "Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "description": "Max items to return (default 50, max 500). Flat 2 credits per call."
    },
    "cursor": {
      "type": "string",
      "description": "Pagination cursor. Leave empty for the first page; then pass the nextCursor value returned in the previous response."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "url"
  ],
  "properties": {
    "url": {
      "type": "string",
      "format": "uri",
      "description": "Public YouTube Shorts URL, e.g. https://youtube.com/shorts/ID (≤3 min). Long-form videos return HTTP 422 — use the matching /v1/youtube/… endpoint instead. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble."
    },
    "cache": {
      "type": "boolean",
      "description": "Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "description": "Max items to return (default 50, max 500). Flat 2 credits per call."
    },
    "cursor": {
      "type": "string",
      "description": "Pagination cursor. Leave empty for the first page; then pass the nextCursor value returned in the previous response."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "url"
  ],
  "properties": {
    "url": {
      "type": "string",
      "format": "uri",
      "description": "Public YouTube Shorts URL, e.g. https://youtube.com/shorts/ID (≤3 min). Long-form videos return HTTP 422 — use the matching /v1/youtube/… endpoint instead. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble."
    },
    "cache": {
      "type": "boolean",
      "description": "Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "url"
  ],
  "properties": {
    "url": {
      "type": "string",
      "format": "uri",
      "description": "Public YouTube Shorts URL, e.g. https://youtube.com/shorts/ID (≤3 min). Long-form videos return HTTP 422 — use the matching /v1/youtube/… endpoint instead. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble."
    },
    "cache": {
      "type": "boolean",
      "description": "Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh."
    },
    "language": {
      "type": "string",
      "description": "Preferred caption language as an ISO code, e.g. \"en\". Defaults to auto-detect."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "url"
  ],
  "properties": {
    "url": {
      "type": "string",
      "format": "uri",
      "description": "Public YouTube Shorts URL, e.g. https://youtube.com/shorts/ID (≤3 min). Long-form videos return HTTP 422 — use the matching /v1/youtube/… endpoint instead. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble."
    },
    "cache": {
      "type": "boolean",
      "description": "Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh."
    },
    "language": {
      "type": "string",
      "description": "Preferred caption language as an ISO code, e.g. \"en\". Defaults to auto-detect."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "url"
  ],
  "properties": {
    "url": {
      "type": "string",
      "format": "uri",
      "description": "Public YouTube video URL, e.g. https://youtube.com/watch?v=ID. Not a TikTok/Instagram/Facebook URL. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble."
    },
    "cache": {
      "type": "boolean",
      "description": "Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh."
    },
    "language": {
      "type": "string",
      "description": "Preferred caption language as an ISO code, e.g. \"en\". Defaults to auto-detect."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "url"
  ],
  "properties": {
    "url": {
      "type": "string",
      "format": "uri",
      "description": "Public YouTube video URL, e.g. https://youtube.com/watch?v=ID. Not a TikTok/Instagram/Facebook URL. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble."
    },
    "cache": {
      "type": "boolean",
      "description": "Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh."
    },
    "language": {
      "type": "string",
      "description": "Preferred caption language as an ISO code, e.g. \"en\". Defaults to auto-detect."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "q": {
      "type": "string",
      "description": "Optional topic seed for the Shorts recommendation sequence. Omit (or pass trending/shorts) for the default reel feed — not a keyword search."
    },
    "cache": {
      "type": "boolean",
      "description": "Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "description": "Max items to return (default 20, max 100). Returns a single window; use limit to size it. No cursor. Flat 2 credits per call."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "url"
  ],
  "properties": {
    "url": {
      "type": "string",
      "format": "uri",
      "description": "Public YouTube video URL, e.g. https://youtube.com/watch?v=ID. Not a TikTok/Instagram/Facebook URL. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble."
    },
    "cache": {
      "type": "boolean",
      "description": "Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "url"
  ],
  "properties": {
    "url": {
      "type": "string",
      "format": "uri",
      "description": "Public YouTube video URL, e.g. https://youtube.com/watch?v=ID. Not a TikTok/Instagram/Facebook URL. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble."
    },
    "cache": {
      "type": "boolean",
      "description": "Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh."
    },
    "minVotes": {
      "type": "integer",
      "minimum": 1,
      "description": "Minimum SponsorBlock votes to keep a segment. Default 0 (drops community-rejected votes < 0)."
    },
    "categories": {
      "type": "string",
      "description": "Comma-separated categories. Default sponsor,selfpromo,interaction. Also intro,outro,preview,music_offtopic,poi_highlight,filler."
    }
  },
  "additionalProperties": false
}