MCP 서버

Viral Outliers

com.viraloutliers/viral-outliers

이 MCP로 할 수 있는 일

Finds viral outlier posts across TikTok, Instagram, and YouTube, tracks creator profiles, analyzes media, monitors watchlists, and generates niche-adapted content ideas.

add_watchlist_profiles
Add Creators to a Watchlist
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 allowance, which comes from a subscription or is earned from API spend; an over-limit call explains what unlocks more. Cost: free.
입력 스키마
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['watchlistId'], 'properties': {'handles': {'type': 'array', 'items': {'type': 'object', 'required': ['platform', 'handle'], 'properties': {'handle': {'type': 'string'}, 'platform': {'enum': ['tiktok', 'instagram', 'youtube'], 'type': 'string'}}}, 'description': 'Handle pairs to resolve and add (profileIds + handles â\x89¤ 25 per call)'}, 'profileIds': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Internal profile ids to add'}, 'watchlistId': {'type': 'string', 'description': 'Target watchlist id'}}}
compare_profiles
Compare Profiles Head-to-Head
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.
읽기 전용 멱등성
입력 스키마
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'handles': {'type': 'array', 'items': {'type': 'object', 'required': ['platform', 'handle'], 'properties': {'handle': {'type': 'string'}, 'platform': {'enum': ['tiktok', 'instagram', 'youtube'], 'type': 'string'}}}, 'description': 'Handle pairs to resolve; 2â\x80\x935 profiles total across both fields'}, 'profileIds': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Profile ids to compare'}}}
crawl_profile
Crawl a New Profile
Submits a public profile for crawling: profile metadata plus its recent posts, stats and thumbnails, after which it stays tracked and appears in searches. Asynchronous. Returns a job reference for get_job_status. If the profile is already tracked, this returns immediately without charging a full crawl. Credits are refunded automatically when a crawl fails. Cost: 40 credits per call.
외부 접근 가능
입력 스키마
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['platform', 'handle'], 'properties': {'handle': {'type': 'string'}, 'platform': {'enum': ['tiktok', 'instagram', 'youtube'], 'type': 'string'}}}
create_topup_link
Create a Credit Top-Up Link
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.
외부 접근 가능
입력 스키마
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['packId'], 'properties': {'packId': {'enum': ['pack_s', 'pack_m', 'pack_l'], 'type': 'string', 'description': 'Credit pack to buy â\x80\x94 see get_credit_balance / docs for sizes'}}}
create_viral_alert
Email Me When a Profile Goes Viral
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 (crawl_profile it first if not). Setting up, listing and deleting alerts is free. Two things cost credits: the refresh crawl that keeps the profile fresh (10 credits per run, daily by default, started for you if you are not already monitoring the profile with track_profile) and each alert email actually sent (5 credits). Limits: one alert email per destination address per day, sent around sendHour in your timezone (defaults 9, UTC) and bundling every alert that fired; 3 emails per alert in total, after which the alert ends; expiresInDays (default 30, max 90) ends it regardless; 25 active alerts per account. A post can trigger an alert only once. Your account email needs no confirmation; any other address receives a confirmation link first and nothing is sent until it is clicked. Every alert email has its own stop link. Calling again for the same profile and address updates the settings instead of creating a duplicate. Cost: free.
외부 접근 가능
입력 스키마
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['email'], 'properties': {'url': {'type': 'string', 'description': 'Public profile or post URL identifying the profile'}, 'email': {'type': 'string', 'description': 'Where to send the alert. Your account email needs no confirmation; any other address gets a confirmation link first'}, 'handle': {'type': 'string', 'description': 'Public handle, without @ (pair with platform)'}, 'platform': {'enum': ['tiktok', 'instagram', 'youtube'], 'type': 'string', 'description': 'With handle: resolve the profile to watch'}, 'sendHour': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991, 'description': 'Preferred hour of day for the email, 0-23 (default 9)'}, 'timezone': {'type': 'string', 'description': 'IANA timezone for sendHour, e.g. Europe/Brussels (default UTC)'}, 'frequency': {'enum': ['daily', 'every_3_days', 'weekly'], 'type': 'string', 'description': 'Refresh cadence for the profile if tracking is started by this alert (default daily)'}, 'profileId': {'type': 'string', 'description': 'Internal profile id from search results'}, 'postAgeDays': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991, 'description': 'Only posts published within this many days can trigger (default 7, max 30)'}, 'scoreWindow': {'enum': ['one_week', 'two_weeks', 'one_month', 'three_months', 'six_months', 'one_year', 'all_time'], 'type': 'string', 'description': 'Which profile average the score is measured against (default three_months)'}, 'expiresInDays': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991, 'description': 'The alert ends after this many days (default 30, max 90)'}, 'minOutlierScore': {'type': 'number', 'description': 'Trigger at this outlier score or above (views / the profile average; default 3, minimum 1.5)'}}}
create_watchlist
Create a Watchlist
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 (every API key holder starts with 1); an over-limit call explains what unlocks more. Cost: free.
입력 스키마
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['name'], 'properties': {'name': {'type': 'string', 'description': 'Display name, 1-80 characters'}, 'notes': {'type': 'string', 'description': 'Optional notes, up to 500 characters'}}}
delete_viral_alert
Delete a Viral Alert
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.
입력 스키마
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['alertId'], 'properties': {'alertId': {'type': 'string', 'description': 'Alert id from list_viral_alerts or create_viral_alert'}}}
delete_watchlist
Delete a Watchlist
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.
입력 스키마
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['watchlistId'], 'properties': {'watchlistId': {'type': 'string', 'description': 'API-created watchlist id'}}}
download_post_media
Download Post Media
Returns direct media URLs for a tracked post, the video file, or slideshow images with positions. Accepts a public post URL or an internal post id. When media is not stored yet it queues an on-demand fetch and returns a jobRef to poll (typically ready within ~90 seconds); call again once complete. Platform CDN URLs can expire, so download promptly. YouTube currently returns the thumbnail image. You are responsible for using downloaded media in line with the platforms' terms and applicable law. Cost: 3 credits per call.
외부 접근 가능
입력 스키마
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'url': {'type': 'string', 'description': 'Public post URL (alternative to postId)'}, 'postId': {'type': 'string', 'description': 'Internal post id'}}}
find_related_social_media_profiles
Find Related Social Media Profiles
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 captions, then returned ranked with recommended = qualified and on-topic. Accounts already in the database come back flagged known with their profileId. Nothing is crawled or added automatically: call crawl_profile for the ones you want. Priced up to 25 credits per call: 5 base plus 1 per account actually screened, the rest refunded (nothing found = fully refunded). Pass topic to say what related means for your use case. Not for looking up a known creator (use search_profiles). Cost: 25 credits per call.
외부 접근 가능
입력 스키마
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['platform'], 'properties': {'limit': {'type': 'integer', 'maximum': 20, 'minimum': 1, 'description': 'Candidates to screen and return (default 10, max 20).'}, 'query': {'type': 'string', 'description': 'Search phrase: creators behind the top results.'}, 'topic': {'type': 'string', 'description': 'What "related" means for the relevance judge, e.g. "home workouts for women". Defaults to the seed.'}, 'handle': {'type': 'string', 'description': 'Seed creator handle: walk who they follow (TikTok) or collaborate with / tag (Instagram). Not on YouTube.'}, 'hashtag': {'type': 'string', 'description': 'Hashtag without #: creators posting under it.'}, 'platform': {'enum': ['tiktok', 'instagram', 'youtube'], 'type': 'string'}}}
get_credit_balance
Check Credit Balance
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. Free to call. Agents should check the balance before starting large batch jobs and surface "insufficient_credits" errors to the user with a link to top up. Cost: free.
읽기 전용 멱등성
입력 스키마
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {}}
get_job_status
Check Job Status
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.
읽기 전용 멱등성
입력 스키마
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['jobRef'], 'properties': {'jobRef': {'type': 'string'}}}
get_post
Get Post Details
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 new enrichment via request_transcript (speech / on-screen text) or request_visual_analysis (scene breakdown). Use after search_outliers to deep-dive a result. Cost: 1 credit per call.
읽기 전용 멱등성
입력 스키마
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['postId'], 'properties': {'postId': {'type': 'string', 'description': 'Internal post id from search results'}, 'includeTranscript': {'type': 'boolean', 'description': 'Attach cached transcript (default true)'}, 'includeVisualAnalysis': {'type': 'boolean', 'description': 'Attach cached visual analysis (default true)'}}}
get_pricing
Get API Pricing
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 against buying packs, without hardcoding prices or holding an API key. Billable calls also return X-Credits-Charged and X-Credits-Balance response headers, so a reseller can attribute spend per call. Cost: free.
읽기 전용 멱등성
입력 스키마
{'type': 'object', 'properties': {}}
get_profile
Get Profile Stats
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.
읽기 전용 멱등성
입력 스키마
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'handle': {'type': 'string'}, 'platform': {'enum': ['tiktok', 'instagram', 'youtube'], 'type': 'string', 'description': 'With handle: look up by handle instead of id'}, 'profileId': {'type': 'string', 'description': 'Profile id from search results'}}}
get_remix_result
Fetch a Finished Remix
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.
읽기 전용 멱등성
입력 스키마
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['jobRef'], 'properties': {'jobRef': {'type': 'string', 'description': 'The pipeline jobRef returned by remix_post'}}}
get_tracked_updates
Get New Posts From Monitored Profiles
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 post shape as search_outliers (stats, thumbnail, handle). Total posts are capped (limit 1–100, default 50). Cost: free.
읽기 전용 멱등성
입력 스키마
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'limit': {'type': 'integer', 'maximum': 100, 'minimum': 1, 'description': 'Max posts to return (default 50)'}}}
get_trending_outliers
Trending Viral Outliers (Free)
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.
읽기 전용 멱등성
입력 스키마
{'type': 'object', 'properties': {}}
get_watchlist
Get a Watchlist
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.
읽기 전용 멱등성
입력 스키마
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['watchlistId'], 'properties': {'watchlistId': {'type': 'string', 'description': 'Watchlist id'}}}
list_categories
List Niche Categories
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_outliers, search_profiles or niche_trends to scope them to the creators in that niche; the filter always covers the subtree. Free to call and cached, so call it at the start of a session and reuse the ids. Categories are assigned per creator by our categorizer (reviewed by hand for new niches), which makes this filter more precise than a keyword over captions: it catches creators whose captions are hashtag-only or not in English. Cost: free.
읽기 전용 멱등성
입력 스키마
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'maxLevel': {'type': 'integer', 'maximum': 4, 'minimum': 1, 'description': 'Only niches up to this depth (default 4)'}, 'minProfiles': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 1, 'description': 'Only niches with at least this many profiles in their subtree (default 5)'}}}
list_tracked_profiles
List Monitored Profiles
Returns every profile you are currently monitoring, with its handle, platform, follower count, refresh cadence, next scheduled crawl time, when it was last checked for updates, and any paused reason (e.g. paused for insufficient credits). Free to call. Use it to audit what is being refreshed and what it is costing, or to grab a profileId for untrack_profile. Cost: free.
읽기 전용 멱등성
입력 스키마
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {}}
list_viral_alerts
List Viral Alerts
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 has confirmed, or to grab an alertId for delete_viral_alert. Cost: free.
읽기 전용 멱등성
입력 스키마
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {}}
list_watchlists
List Your Watchlists
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.
읽기 전용 멱등성
입력 스키마
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {}}
niche_trends
What's Trending in a Niche
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.
읽기 전용 멱등성
입력 스키마
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'limit': {'type': 'integer', 'maximum': 50, 'minimum': 1}, 'query': {'type': 'string', 'description': 'Niche keyword'}, 'platforms': {'type': 'array', 'items': {'enum': ['tiktok', 'instagram', 'youtube'], 'type': 'string'}}, 'timeFrame': {'enum': ['all_time', 'one_week', 'two_weeks', 'one_month', 'three_months', 'six_months', 'one_year'], 'type': 'string', 'description': 'Default one_week'}, 'categoryId': {'type': 'string', 'description': 'Niche filter: a category id from list_categories (covers its subtree)'}}}
remix_post
Remix a Post to Your Niche
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 automatically as part of the job, so any public TikTok/Instagram/YouTube link works with no crawl_profile round-trip. Asynchronous (~1–3 minutes, a few minutes longer for an untracked URL): returns a jobRef; poll get_remix_result until its "remix" field is populated (it returns status + result together). For video posts the remix auto-generates the transcript and visual analysis first, so quality no longer depends on you transcribing beforehand. Credits are refunded automatically if the remix fails. Cost: 20 credits per call.
외부 접근 가능
입력 스키마
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['targetNiche'], 'properties': {'url': {'type': 'string', 'description': 'Public post URL (alternative to postId â\x80\x94 what a user browsing social media has)'}, 'tone': {'type': 'string', 'description': 'Preferred tone of voice'}, 'postId': {'type': 'string', 'description': 'Internal post id'}, 'targetNiche': {'type': 'string', 'description': 'Your niche/brand/audience, 5â\x80\x93500 chars'}}}
remove_watchlist_profiles
Remove Creators from a Watchlist
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.
입력 스키마
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['watchlistId', 'profileIds'], 'properties': {'profileIds': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Internal profile ids to remove'}, 'watchlistId': {'type': 'string', 'description': 'Watchlist id'}}}
report_issue
Report an Issue
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: free.
입력 스키마
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['message'], 'properties': {'skill': {'type': 'string', 'description': 'Which skill the issue is about, when known'}, 'message': {'type': 'string', 'description': 'What you called, what you expected, what happened (10â\x80\x932000 chars)'}, 'wantsUpdate': {'type': 'boolean', 'description': 'true = email the account owner when resolved'}}}
request_transcript
Transcribe a Post
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 charge: use request_visual_analysis for their on-screen text instead. Cost: 10 credits per call.
외부 접근 가능
입력 스키마
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'url': {'type': 'string', 'description': 'Public post URL (alternative to postId)'}, 'postId': {'type': 'string', 'description': 'Internal post id'}}}
request_visual_analysis
Analyze a Post Visually
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, per-slide text and visual descriptions. Accepts a public post URL or an internal post id. Asynchronous: returns a job reference to poll with get_job_status; once complete the analysis is attached to get_post responses (includeVisualAnalysis). Credits are charged on queueing and automatically refunded if the job fails. This is the visual twin of request_transcript. Cost: 10 credits per call.
외부 접근 가능
입력 스키마
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'url': {'type': 'string', 'description': 'Public post URL (alternative to postId)'}, 'postId': {'type': 'string', 'description': 'Internal post id'}}}
resolve_post_url
Resolve a Post URL
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 untracked URL directly and ingests it itself, so for a remix you can skip this lookup. TikTok/Instagram short links (vm.tiktok.com, /share/) must be expanded to the canonical URL first. Cost: 1 credit per call.
읽기 전용 멱등성
입력 스키마
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['url'], 'properties': {'url': {'type': 'string', 'description': 'Public post URL (canonical, not a short link)'}}}
search_outliers
Search Viral Outlier Posts
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 recency. Returns post metadata, stats and thumbnails. Use this to find proven viral formats in any niche before creating content. Results may include deleted posts (deleted_at set) and posts from deactivated profiles (profile is_active=false), these are kept for their thumbnails and format ideas, with stats frozen at deletion; filter on deleted_at / is_active if you only want live content. Cost: 1 credit per call.
읽기 전용 멱등성
입력 스키마
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'page': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 1}, 'query': {'type': 'string', 'description': 'Keyword search over captions/titles'}, 'handle': {'type': 'string', 'description': 'Exact creator handle filter'}, 'sortBy': {'enum': ['outlier_desc', 'outlier_asc', 'views_desc', 'views_asc', 'likes_desc', 'likes_asc', 'date_desc', 'date_asc', 'engagement_desc', 'engagement_asc'], 'type': 'string'}, 'maxViews': {'type': 'number'}, 'minViews': {'type': 'number'}, 'pageSize': {'type': 'integer', 'maximum': 100, 'minimum': 1}, 'platforms': {'type': 'array', 'items': {'enum': ['tiktok', 'instagram', 'youtube'], 'type': 'string'}}, 'timeFrame': {'enum': ['all_time', 'one_week', 'two_weeks', 'one_month', 'three_months', 'six_months', 'one_year'], 'type': 'string'}, 'categoryId': {'type': 'string', 'description': 'Niche filter: a category id from list_categories (covers its subtree)'}, 'watchlistId': {'type': 'string', 'description': 'Scope to the creators in one of your watchlists (id from list_watchlists)'}, 'contentTypes': {'type': 'array', 'items': {'type': 'string'}}, 'maxFollowers': {'type': 'number'}, 'minFollowers': {'type': 'number'}, 'maxOutlierScore': {'type': 'number'}, 'minOutlierScore': {'type': 'number'}, 'maxEngagementRate': {'type': 'number'}, 'minEngagementRate': {'type': 'number'}}}
search_profiles
Search Social Media Profiles
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 stats; filter on is_active if you only want live accounts. Note a creator who changed handles can appear as two rows (old deactivated + new active). Cost: 1 credit per call.
읽기 전용 멱등성
입력 스키마
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'page': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 1}, 'query': {'type': 'string', 'description': 'Handle, @handle, or profile URL'}, 'pageSize': {'type': 'integer', 'maximum': 100, 'minimum': 1}, 'platforms': {'type': 'array', 'items': {'enum': ['tiktok', 'instagram', 'youtube'], 'type': 'string'}}, 'categoryId': {'type': 'string', 'description': "Niche filter: a category id from list_categories (covers its subtree); without a query returns that niche's top profiles"}}}
track_profile
Monitor a Profile
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 balance runs out, then resumes when you top up. The profile must already be in the database; crawl_profile it first if it is not. Calling again on an already-monitored profile just updates the cadence. Pull the new posts with get_tracked_updates. Cost: free.
외부 접근 가능
입력 스키마
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'url': {'type': 'string', 'description': 'Public profile or post URL identifying the profile'}, 'handle': {'type': 'string', 'description': 'Public handle, without @ (pair with platform)'}, 'platform': {'enum': ['tiktok', 'instagram', 'youtube'], 'type': 'string', 'description': 'With handle: resolve the profile to monitor'}, 'frequency': {'enum': ['daily', 'every_3_days', 'weekly'], 'type': 'string', 'description': 'Refresh cadence (default weekly)'}, 'profileId': {'type': 'string', 'description': 'Internal profile id from search results'}}}
untrack_profile
Stop Monitoring a Profile
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.
입력 스키마
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['profileId'], 'properties': {'profileId': {'type': 'string', 'description': 'Internal profile id to stop monitoring'}}}
추가됨
delete_viral_alert
2026년 9월 29일 3:03 AM
추가됨
list_viral_alerts
2026년 9월 29일 3:03 AM
추가됨
create_viral_alert
2026년 9월 29일 3:03 AM
변경됨
niche_trends
2026년 9월 29일 3:03 AM
변경됨
find_related_social_media_profiles
2026년 9월 29일 3:03 AM
추가됨
list_categories
2026년 9월 29일 3:03 AM
변경됨
search_profiles
2026년 9월 29일 3:03 AM
변경됨
search_outliers
2026년 9월 29일 3:03 AM
추가됨
find_related_social_media_profiles
2026년 9월 27일 2:54 AM
추가됨
get_pricing
2026년 9월 17일 12:38 PM
추가됨
get_trending_outliers
2026년 9월 17일 12:38 PM
추가됨
get_tracked_updates
2026년 9월 17일 12:38 PM
추가됨
delete_watchlist
2026년 9월 17일 12:38 PM
추가됨
remove_watchlist_profiles
2026년 9월 17일 12:38 PM
추가됨
add_watchlist_profiles
2026년 9월 17일 12:38 PM
추가됨
get_watchlist
2026년 9월 17일 12:38 PM
추가됨
list_watchlists
2026년 9월 17일 12:38 PM
추가됨
create_watchlist
2026년 9월 17일 12:38 PM
추가됨
list_tracked_profiles
2026년 9월 17일 12:38 PM
추가됨
untrack_profile
2026년 9월 17일 12:38 PM
추가됨
track_profile
2026년 9월 17일 12:38 PM
추가됨
report_issue
2026년 9월 17일 12:38 PM
추가됨
create_topup_link
2026년 9월 17일 12:38 PM
추가됨
get_remix_result
2026년 9월 17일 12:38 PM
추가됨
remix_post
2026년 9월 17일 12:38 PM
추가됨
download_post_media
2026년 9월 17일 12:38 PM
추가됨
resolve_post_url
2026년 9월 17일 12:38 PM
추가됨
niche_trends
2026년 9월 17일 12:38 PM
추가됨
compare_profiles
2026년 9월 17일 12:38 PM
추가됨
get_credit_balance
2026년 9월 17일 12:38 PM