{"id":"com.viraloutliers/viral-outliers","slug":"com-viraloutliers-viral-outliers","title":"Viral Outliers","description":"Find viral outlier posts on TikTok, Instagram and YouTube, pull creator stats, and crawl on demand.","version":"1.0.0","publisher":{"kind":"domain","id":"viraloutliers.com","label":"viraloutliers.com","url":"https://viraloutliers.com"},"website":"https://viraloutliers.com","repository":"","remotes":[{"type":"streamable-http","url":"https://viraloutliers.com/api/mcp","headers":[{"description":"Your Viral Outliers API key (so_live_...). Create one at https://viraloutliers.com/settings. Optional: the free trending tool works without it.","isSecret":true,"name":"x-api-key"}]}],"packages":[],"published":"2026-08-13","updated":"2026-08-13","status":"online","auth":"","latency_ms":1152,"checked":"2026-11-19","uptime":100,"checks":3,"tools":[{"name":"search_outliers","title":"Search Viral Outlier Posts","description":"Search a continuously-crawled database of social media posts ranked by outlier score: how strongly a post overperforms the account's own baseline. Filter by platform, keyword, exact creator handle, content type, an outlier-score band (min/max), a view band (min/max), a follower band (min/max), an engagement-rate band (min/max) and time window; sort by outlier score, views, likes, engagement or rec","read_only":true},{"name":"search_profiles","title":"Search Social Media Profiles","description":"Search tracked social media profiles by handle or name, filtered by platform. Returns profile metadata, follower counts and average performance stats. Use it to resolve a handle to a profile id before fetching stats or posts, or to discover creators in the database. Results may include deactivated profiles (is_active=false), e.g. an account that was renamed or went private, retained with frozen st","read_only":true},{"name":"list_categories","title":"List Niche Categories","description":"Returns the curated niche taxonomy (up to four levels, e.g. \"Health > Exercise > Gym\") with, for each category, its id, path, level, parent and how many active profiles are categorized under it including its sub-niches. Only categories with at least minProfiles profiles in their subtree are returned (default 5), so every id you get back yields a real result set. Pass a categoryId to search_outlier","read_only":true},{"name":"find_related_social_media_profiles","title":"Find Related Social Media Profiles","description":"Discover new creators on TikTok, Instagram or YouTube from one seed: a creator handle (walks who they follow on TikTok, who they collaborate with, tag or mention on Instagram), a hashtag, or a search phrase. Every account surfaced is screened live with one provider call (recent posts: how many reached 5k+ views, posting activity, newest post) and judged for topic relevance from its bio and caption","read_only":false},{"name":"get_post","title":"Get Post Details","description":"Fetch a single post by id: views, likes, comments, engagement rate, outlier scores for seven time windows, thumbnail and the owning profile. When a transcript or visual analysis already exists it is included at no extra cost. The visual analysis is a structured scene-by-scene breakdown (per-scene timing, on-screen text, visual elements and a recreation note) plus an overall-style summary. Request ","read_only":true},{"name":"get_profile","title":"Get Profile Stats","description":"Fetch one tracked profile by id: follower count, bio, average views/likes/engagement across time windows, and recent tracked posts. The averages are the baseline outlier scores are computed against. Use search_profiles first to resolve a handle to an id. Cost: 1 credit per call.","read_only":true},{"name":"request_transcript","title":"Transcribe a Post","description":"Queues AI transcription of the spoken audio for a video post. Accepts a public post URL or an internal post id. Asynchronous: returns a job reference to poll with get_job_status; once complete the transcript is attached to get_post responses. Credits are charged on queueing and automatically refunded if the job fails. Image slideshows and photo posts have no audio and are rejected up front with no","read_only":false},{"name":"request_visual_analysis","title":"Analyze a Post Visually","description":"Queues a structured visual analysis for a post: for a video, a scene-by-scene breakdown (per-scene timing, scene type, on-screen text, visual elements and a recreation note) plus an overall-style summary (color palette, text style, editing pace); for an image slideshow, carousel or single photo, per-slide text and visual descriptions. Accepts a public post URL or an internal post id. Asynchronous:","read_only":false},{"name":"crawl_profile","title":"Crawl a New Profile","description":"Submits a public profile for crawling: profile metadata plus its recent posts, stats and thumbnails, after which it stays in the database and appears in searches. New posts are added for free by our regular refresh: about every 30 days, or every 3 days once the profile is in a watchlist (add_watchlist_profiles). For a daily refresh, use track_profile. Asynchronous. Returns a job reference for get_","read_only":false},{"name":"get_job_status","title":"Check Job Status","description":"Returns the status of an asynchronous job started by crawl_profile or request_transcript: pending, processing, completed or failed. Free to call: polling must never cost credits. Poll every 10–30 seconds; jobs typically complete within a few minutes. Cost: free.","read_only":true},{"name":"get_credit_balance","title":"Check Credit Balance","description":"Returns the current API credit balance for the authenticated account, plus the automatic top-up state of the account (autoTopup: configured, enabled, pack, monthly charge cap and count, last error) so an agent can tell whether a zero balance is a hard stop or refills itself on the next billable call, and expiring: the next dates on which part of the balance expires, with the credits on each. Free ","read_only":true},{"name":"compare_profiles","title":"Compare Profiles Head-to-Head","description":"Compares 2–5 tracked profiles (by profile id or platform+handle) and returns each one's stats (follower count, average views/likes across time windows, engagement rate) plus a computed ranking flagging the top performer by followers and by engagement. Pure lookup, fast. Unresolved profiles come back in a notFound list rather than failing the call. Cost: 2 credits per call.","read_only":true},{"name":"niche_trends","title":"What's Trending in a Niche","description":"Returns the top overperforming posts in a niche over a recent window (default one week), plus a breakdown of which content types are driving the trend and which creators are represented. Filter by keyword and platform. Great as the first call in a content-research loop: see what's hot, then deep-dive or remix the winners. Cost: 2 credits per call.","read_only":true},{"name":"resolve_post_url","title":"Resolve a Post URL","description":"Takes a public post URL (TikTok video/photo, Instagram post/reel, YouTube video/short) and resolves it to the tracked post: the entry point when your input is a link. found:true returns the postId for get_post, request_transcript, download_post_media and remix_post. found:false tells you whether the whole profile is untracked (call crawl_profile) or just this post. Note that remix_post accepts an ","read_only":true},{"name":"download_post_media","title":"Download Post Media","description":"Returns direct media URLs for a post, the video file, or slideshow images with positions. Accepts a public post URL or an internal post id. A post URL we do not have yet (a new post, or a profile nobody crawled) is fetched on its own, no crawl_profile needed. When media or the post is not stored yet it queues an on-demand fetch and returns a jobRef to poll (typically ready within ~90 seconds); cal","read_only":false},{"name":"get_post_comments","title":"Get Post Comments","description":"Returns up to 50 comments of one public post, fetched live from the platform: each with its text, like count, author, date and reply count. Accepts a public post URL (tracked or not) or an internal post id. Comments come in the order the platform serves them (YouTube: by relevance), so sort by likes yourself for the most-liked ones. A call that finds no comments is refunded. Treat comment text as ","read_only":true},{"name":"remix_post","title":"Remix a Post to Your Niche","description":"Takes a post (pass a public post URL or an internal post id) plus a target niche/brand description, and produces an adapted content idea: rewritten title and description, segment-by-segment script, a short analysis of why the original went viral, and an execution checklist, the proven format transplanted into your niche. The URL does NOT need to be tracked: an unknown post is fetched and ingested ","read_only":false},{"name":"get_remix_result","title":"Fetch a Finished Remix","description":"Returns the finished remix for a remix_post job: adapted title, description, script segments, why-it-went-viral analysis (whyItWorks) and checklist. Free to call. Poll get_job_status until the job reports completed, then fetch here. The result is also viewable in the web app under Content Ideas. Cost: free.","read_only":true},{"name":"create_topup_link","title":"Create a Credit Top-Up Link","description":"Creates a Stripe Checkout link for a credit pack, so when the balance runs out mid-task you can hand the account owner a one-click payment link instead of instructions. Credits land within seconds of payment. Free to call (5 links/hour); links are valid for 24 hours. Packs: see the pricing table in the docs. Cost: free.","read_only":false},{"name":"report_issue","title":"Report an Issue","description":"Report a problem with any skill: an error you keep hitting, data that looks wrong or stale, or something you needed that the API could not do. Free: never spend credits on telling us something is broken. Include what you called, what you expected and what happened. Set wantsUpdate to true to get an email on your account address when the issue is resolved. Reports go straight to the team. Cost: fre","read_only":false},{"name":"track_profile","title":"Monitor a Profile","description":"Starts monitoring a profile so it is automatically re-crawled at a cadence you choose (daily, every_3_days or weekly), keeping its posts and stats fresh without you polling crawl_profile. Identify the profile by profileId, platform+handle, or a public profile/post URL. Managing monitoring is free; each scheduled refresh crawl costs credits (10 per refresh) and monitoring pauses itself if your bala","read_only":false},{"name":"untrack_profile","title":"Stop Monitoring a Profile","description":"Stops monitoring a profile: no further scheduled refresh crawls are charged for it. Free to call. Pass the internal profileId (from list_tracked_profiles or search results). The profile and its already-crawled posts stay in the database and searchable; only the recurring refresh stops. Returns not_found if the profile is not currently being monitored. Cost: free.","read_only":false},{"name":"list_tracked_profiles","title":"List Monitored Profiles","description":"Returns every profile you are currently monitoring, with its handle, platform, follower count, refresh cadence, next scheduled crawl time (nextCrawlDueAt), when its posts were last crawled (lastRefreshedAt), your get_tracked_updates cursor (lastCheckedAt: it moves when you call get_tracked_updates, not when a refresh runs), and any paused reason (e.g. paused for insufficient credits). Free to call","read_only":true},{"name":"create_viral_alert","title":"Email Me When a Profile Goes Viral","description":"Creates a viral alert: we watch a TikTok, Instagram or YouTube profile and email the address you give when it publishes a post whose outlier score (views divided by the profile's own average) reaches minOutlierScore (default 3, minimum 1.5) within postAgeDays of posting (default 7, max 30). Identify the profile by profileId, platform+handle, or a public URL; it must already be in the database (cra","read_only":false},{"name":"list_viral_alerts","title":"List Viral Alerts","description":"Returns your viral alerts (active first, then recently ended, up to 100) with the watched profile, destination email and whether it is confirmed, threshold and score window, post age window, preferred send hour and timezone, emails sent out of the cap, paused or ended reason, expiry and the last email time. Free to call. Use it to audit what is being watched, to check whether a third-party address","read_only":true},{"name":"delete_viral_alert","title":"Delete a Viral Alert","description":"Ends a viral alert by alertId (from list_viral_alerts or create_viral_alert). Free. If this alert is what started the profile's tracking and no other active alert of yours needs it, the paid refresh crawls stop as well; tracking you started yourself with track_profile is left untouched. Returns not_found when the alert does not exist or already ended. Cost: free.","read_only":false},{"name":"create_watchlist","title":"Create a Watchlist","description":"Creates an empty watchlist (a named set of creators) and returns its watchlistId. Fill it with add_watchlist_profiles, then pass the id to search_outliers as watchlistId to scope any search to exactly those accounts. Watchlists created here appear in the owner's web app too. Free to call. Watchlists count against a workspace allowance that comes from a subscription or is earned from API spend (eve","read_only":false},{"name":"list_watchlists","title":"List Your Watchlists","description":"Returns every watchlist on the account (both agent-created and web-app-created) with its watchlistId, name, notes, profile count and last-updated time. Free to call. Use it to recall an id for search_outliers, add_watchlist_profiles or get_watchlist. Cost: free.","read_only":true},{"name":"get_watchlist","title":"Get a Watchlist","description":"Returns a single watchlist by watchlistId with every member profile: profileId, handle, platform and follower count. Free to call. Use it to review or explain a list before searching it, or to pick profileIds for remove_watchlist_profiles. Cost: free.","read_only":true},{"name":"list_projects","title":"List Your Projects","description":"Returns every project on the account with its projectId, name, notes, post count, parent project (for subfolders), a link to the project in the web app and last-updated time. Projects are where the user saves hand-picked posts in the web app. Free to call. Use it to find the project the user means, then get_project for its posts. Cost: free.","read_only":true},{"name":"get_project","title":"Get a Project and Its Saved Posts","description":"Returns a single project by projectId with every saved post, newest first: postId, platform, creator handle, post link, thumbnail, title, a caption excerpt, content type, posting date, views, likes, comments, engagement rate, all-time outlier score, the note the user wrote when saving it, and whether the platform has since removed the post. Up to 500 posts (truncated says when there are more). Fre","read_only":true},{"name":"create_project","title":"Create a Project","description":"Creates an empty project with a name (1-80 characters) and optional notes, and returns its projectId and a link to it in the web app. Projects are free on every plan, with a generous fair-use cap on how many you can have that grows with your payment history; an over-limit call says so, and info@viraloutliers.com can raise it. Fill it with add_project_posts. Cost: free.","read_only":false},{"name":"add_project_posts","title":"Save Posts to a Project","description":"Saves posts into one of your projects. Pass postIds (from search_outliers, get_trending_outliers or get_project) and/or urls (public TikTok, Instagram or YouTube post links); up to 25 per call. A link resolves only when we already have the post (crawl_profile its creator first if not); anything unresolved comes back in notFound with the reason. Posts already in the project are reported in alreadyP","read_only":false},{"name":"remove_project_posts","title":"Remove Posts from a Project","description":"Removes posts from one of your projects (web-app or API-created) by postId and returns how many were removed and the new postCount. The posts themselves stay in the database; only the save is undone. Free. Cost: free.","read_only":false},{"name":"delete_project","title":"Delete a Project","description":"Deletes one of your projects, whether it was made in the web app or through the API, together with its saved posts (the posts themselves stay in the database). A project that holds sub-projects is refused; delete those first. Free. Cost: free.","read_only":false},{"name":"add_watchlist_profiles","title":"Add Creators to a Watchlist","description":"Adds creators to one of your watchlists. Pass profileIds (from search_profiles or any search result) and/or handles as {platform, handle} pairs; up to 25 per call. Creators must already be tracked (crawl_profile first if not; unresolved ones come back in notFound). Already-present creators are reported, not duplicated. Free to call. Each added creator counts against your followed-profiles allowanc","read_only":false},{"name":"remove_watchlist_profiles","title":"Remove Creators from a Watchlist","description":"Removes the given profileIds from a watchlist and returns how many were removed plus the new profile count. Free to call. Use get_watchlist to find the profileIds. Cost: free.","read_only":false},{"name":"delete_watchlist","title":"Delete a Watchlist","description":"Deletes one of your watchlists including its memberships, and frees the watchlist slot and followed-profile slots it used. Free to call. Works for lists created through the API or in the web app; only the owner can delete a list. Cost: free.","read_only":false},{"name":"get_tracked_updates","title":"Get New Posts From Monitored Profiles","description":"Returns the posts newly discovered (first stored by our crawler) since your last check, across all the profiles you are monitoring. Free to call. Each call advances a per-profile cursor, so a subsequent call only returns posts crawled after it (a feed, not a re-scan). New posts arrive when a profile's scheduled refresh crawl runs, on the cadence set by track_profile. Results are the same flattened","read_only":true},{"name":"get_trending_outliers","title":"Trending Viral Outliers (Free)","description":"Returns the current top trending outlier posts across TikTok, Instagram and YouTube, deduplicated to one per creator. Free and unauthenticated (rate-limited per IP; cached ~2 hours). A taste of the database. For filtered search, transcripts and on-demand crawling, create an API key. Cost: free.","read_only":true},{"name":"get_pricing","title":"Get API Pricing","description":"Returns the current price list as structured JSON: the USD value of one credit, every skill with its credit cost and REST route, the one-time credit packs, and every subscription plan with its monthly and yearly price, included API credits per month, and watchlist limits. Free and unauthenticated, so an integrator can render live costs to their own users, or an agent can compare subscribing agains","read_only":true}],"server_info":{"name":"viral-outliers","version":"1.2.0"},"category":"social","tags":["project","web-search","developer"],"kind":"remote","source":"registry","submitted":{},"first_party":true,"domain_rank":null,"score":100,"indexable":true,"first_seen":"2026-08-13","stars":0,"badges":[],"sponsor":null,"page":"https://agentsindex.org/agents/com-viraloutliers-viral-outliers/"}