Skip to content

List videos

Videos with each one's hook, caption, creator, views, viral factor, engagement rate, niche, formats and page URL, newest first unless sorted. Filter by a niche, format or brand slug (from List niches / List formats / List brands), a platform, or a creator on a platform. Needs an account; every plan gets search, sort and every filter (up to 48 a page, offset up to 2400). The trial and every paid plan page through every list. Without a plan, MCP answers hold a list's first 4 results, the number it matched and no next offset, and API requests are refused. An answer served while the plan cannot be read holds a list's first 20 results, as the site shows them signed out: it pages with an offset up to there, a limit that would pass 20 is cut, the page that reaches it returns no next offset, and an offset of 20 or more is refused. Each request counts against the team's call allowance, shared with MCP; past it, a 402.

get/api/v1/videos

Authentication

OAuth token, API key or signed-in session, sent as Authorization: Bearer <token> (a session rides on its cookie). An OAuth token needs mcp:read. See authentication.

Query parameters

  • nichestring

    A niche slug from List niches, e.g. fitness.

  • formatstring

    A format slug from List formats.

  • brandstring

    A brand slug from List brands (its name, short name or @handle also read as the brand): only the videos promoting that app or brand.

  • platformenum

    Only this platform. Required with creator. One of tiktok, instagram.

  • creatorstring

    A username (letters, digits, . and _); needs platform.

  • limitinteger

    How many videos, up to 48. Default 24.

  • offsetinteger

    The previous page's next_offset. Past the cap the answer is an empty page. Without a plan, an offset of 20 or more answers 402 (plan_limit). Default 0.

  • searchstring

    Free text over niche, formats, hook, caption, creator and platform. Accents are ignored, and a last word of four letters or more is also read as a word start ("morn" finds morning) when no video holds every word. When the first page holds no video, misspelt words are corrected to the closest words the library uses and searched once more: corrected_query then says what was searched.

  • sortenum

    viral = highest viral factor first; views; recent (the default order). One of viral, views, recent.

  • time_periodenum

    Posted in the last 7, 30, 90 or 365 days. One of 7d, 30d, 90d, 365d.

  • viral_factorenum

    Minimum viral factor. One of 4, 8, 32.

  • content_typeenum

    Video or photo posts. One of video, photo.

  • creator_genderenum

    The creator's gender. One of male, female.

Response fields

  • videosarray of Video

    Each with id, url, original_url, platform, creator, creator_url, hook, caption, language, hook_tactic, tone, visual_formats, views, viral_factor, engagement_rate, niche, formats, posted_at, cover.

  • next_offsetinteger or null

    Pass as offset for the next page; null when there is none.

  • corrected_querystring

    Present when the search found no video as written and the videos are for these corrected words.

  • notestring

    When the account's plan stops the list on this page while it holds more: says so and links the plans page.

Responses

  • 200

    Viral videos for a niche, format, platform or creator.

  • 400

    A parameter is malformed or not supported. Body: Problem.

  • 401

    No account: send an API key, an OAuth access token or a session cookie. WWW-Authenticate names the protected-resource metadata. Body: Problem.

  • 402

    The team's call allowance is used up (quota_exceeded), or the account has no plan and so no calls (no_plan), or an account with no plan asked past a list's first page (plan_limit); resolution says what to do and links the plans page. Body: Problem.

  • 403

    The token lacks mcp:read. Body: Problem.

  • 404

    No such niche, format, brand, creator, page or endpoint. Body: Problem.

  • 429

    Rate limit exceeded; wait Retry-After seconds. Body: Problem.

  • 500

    The request failed on our side. Body: Problem.