Skip to content

Viral Swipe File developer docs

Viral Swipe File is the viral video library for marketers and their AI agents: Instagram Reels and TikToks ranked by viral factor, each with its hook, views, niche and format. Software can use it four ways, from no setup to full access. The pages and the library are read-only; the JSON API and the MCP server also save videos, organize boards and follow creators in your own workspace, with the mcp:write scope.

MCP tools: search_library, list_videos, get_video, list_niches, list_formats, list_brands, get_brand, list_saved_videos, list_followed_videos, list_boards, list_workspaces, switch_workspace, get_usage, get_saved_video, save_video, unsave_video, set_video_note, create_board, rename_board, delete_board, share_board, unshare_board, add_video_to_board, remove_video_from_board, follow_creator, unfollow_creator. Starter prompts: what-to-post, viral-videos-in-my-niche, swipe-a-creator, hooks-for-my-product, map-a-niche.

When to use Viral Swipe File

Use it when a task needs real examples of short-form videos that went viral: hooks that worked in a niche, which formats outperform, a creator's best videos, or inspiration for a script. Do not use it for live trends from this week, for analytics on your own account, or to download or repost other people's videos.

Markdown pages

Send Accept: text/markdown to any page URL (the home page, niches, brands, a niche, a format, a brand, a creator or a video page) and the same page comes back as markdown at the same URL. A client that accepts neither markdown nor HTML gets 406. The same renditions are at /md/{path} for clients that cannot set headers. The sitemap index lists the home, niche, format, brand and editorial pages, the creators with at least 5 videos, and a curated set of video pages: of the videos with a viral factor of 3 or more, at least 100,000 views, a real hook and a cover, the top 400 by viral factor, at most 5 per creator and 50 per niche. Every other video page still works but is marked noindex.

Machine-readable files

Access and limits

Scroll sideways to see every column.

PlanPriceVideos per listMCP and API calls
Starter$29 a monthEvery video10,000 a month, at most 1,000 a day
Growth$99 a monthEvery video50,000 a month, at most 3,000 a day
7-day free trialNothing until day 8, card requiredEvery video200 a day
Signed in, no planNothingThe first 4A preview: 20 MCP calls in all, no API
  • Markdown pages need no account and show the signed-out view: the first 20 videos of a list.
  • The JSON API and the MCP server need Starter or Growth or their trial. An account with no plan can sign in: the JSON API refuses every request, and the MCP server answers only its preview. 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.
  • The MCP server and the JSON API come with every plan, hooks and captions included, and count against one allowance: MCP tool calls and API requests together. During the trial: 200 calls a day, counted from midnight UTC. Starter: 10,000 calls a month, up to 1,000 a day. Growth: 50,000 a month, up to 3,000 a day. Months count from the 1st (UTC). An account without a plan gets a preview over MCP: 20 calls in all, each list cut to its first 4 results, and no API. See the plans.

MCP tool calls and API requests share one allowance: how calls count.

Questions: [email protected].