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.
Accept: text/markdown returns that page as markdown.JSON APIOn Starter, Growth or their 7-day free trial (OAuth token, API key or signed-in session): the library (search, videos, niches, formats, brands) and your workspace (saved videos and notes, boards and share links, follows, workspaces, usage); 30 requests a minute per account. Every endpoint is listed in the API reference.MCP serverOn Starter, Growth or their 7-day free trial, with one OAuth sign-in: the same library and workspace as tools for your assistant. The same token works for the JSON API.llms.txtNo setup: the map of the site for a language model.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
- llms.txt and llms-full.txt: what the site covers, when to use it, every way in; the full file adds the API and every MCP tool
- skill.mdan agent skill with when-to-use instructions
- openapi.jsonthe JSON API, OpenAPI 3.1
- mcp.jsonthe MCP server card
- sitemap.xmlevery public page
Access and limits
Scroll sideways to see every column.
| Plan | Price | Videos per list | MCP and API calls |
|---|---|---|---|
| Starter | $29 a month | Every video | 10,000 a month, at most 1,000 a day |
| Growth | $99 a month | Every video | 50,000 a month, at most 3,000 a day |
| 7-day free trial | Nothing until day 8, card required | Every video | 200 a day |
| Signed in, no plan | Nothing | The first 4 | A 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].