{ "description": "List the TikTok accounts you want to monitor. The tracker finds public posts that tag or @mention each account, labels why every post matched, and lets you narrow results by date, views and order.", "properties": { "addPostCountry": { "default": false, "description": "Look up the country TikTok records for every saved post (locationCreated, e.g. US, BR, JP). Useful for market breakdowns of who mentions you. Adds a few seconds per post.", "prefill": false, "title": "Add the country each post was made in", "type": "boolean" }, "datePosted": { "default": "anyTime", "description": "Only look at posts published in this period.", "editor": "select", "enum": [ "anyTime", "past24Hours", "pastWeek", "pastMonth", "past3Months", "past6Months" ], "enumTitles": [ "Any time", "Last 24 hours", "Last 7 days", "Last 30 days", "Last 3 months", "Last 6 months" ], "title": "Posted within", "type": "string" }, "downloadVideos": { "default": false, "description": "Download each saved video into this run's key-value store and add a permanent link to it (downloadedVideoUrl). TikTok's own video links only play inside TikTok, so turn this on when you need playable files. It makes runs slower and uses storage.", "prefill": false, "title": "Save video files", "type": "boolean" }, "excludeOwnPosts": { "default": true, "description": "Leave out posts published by the tracked account itself, so you only see what other people say about it.", "prefill": true, "title": "Skip the account's own posts", "type": "boolean" }, "followRelatedVideos": { "default": false, "description": "After searching, open TikTok's related videos for every post that tags the account and keep related posts that also mention it (repeating a few hops). Often finds many extra tagged posts, mostly from creators who tag the account regularly. Slower, and needs at least 4096 MB of run memory.", "prefill": false, "title": "Also follow related videos", "type": "boolean" }, "maxItems": { "description": "Optional limit across all accounts in this run. Leave empty for no overall limit.", "minimum": 1, "title": "Max posts in total", "type": "integer" }, "maxResultsPerProfile": { "default": 50, "description": "Stop after this many saved posts for each account. TikTok search usually yields tens to a few hundred posts per account, so very high values simply mean 'everything found'.", "maximum": 500, "minimum": 1, "prefill": 3, "title": "Max posts per account", "type": "integer" }, "mentionFilter": { "default": "taggedOrCaption", "description": "Every saved post carries a mentionType label: 'tagged' (the caption contains TikTok's clickable tag of the account), 'captionText' (the caption types @handle without a working tag) or 'searchResult' (TikTok search returned it for the handle, but the caption doesn't name the account). By default you get real mentions: tagged posts plus @handle captions.", "editor": "select", "enum": [ "taggedOrCaption", "tagged", "all" ], "enumTitles": [ "Real mentions: tagged or @handle in the caption", "Only posts with TikTok's clickable tag", "Every search result, labelled" ], "title": "Which posts to keep", "type": "string" }, "minPlayCount": { "description": "Skip posts with fewer views than this. Leave empty to keep posts of any size.", "minimum": 0, "title": "Minimum views", "type": "integer" }, "postedAfter": { "dateType": "absoluteOrRelative", "description": "Exact cut-off date. Use a date (2026-10-01) or a relative age such as '3 days' or '2 weeks'. Works together with 'Posted within'; the stricter of the two applies.", "editor": "datepicker", "title": "Posted on or after", "type": "string" }, "searchCountry": { "default": "any", "description": "TikTok shows different posts in different countries. Pick a country to see the mentions people there get in their search results (for example Japan for Japanese posts). 'Any' uses the fastest connection. Runs with a country are slower.", "editor": "select", "enum": [ "any", "AR", "AU", "AT", "BD", "BE", "BR", "CA", "CL", "CO", "CZ", "DK", "EG", "FI", "FR", "DE", "GR", "ID", "IE", "IL", "IT", "JP", "KE", "MY", "MX", "MA", "NL", "NZ", "NG", "NO", "PK", "PE", "PH", "PL", "PT", "RO", "SA", "SG", "ZA", "KR", "ES", "SE", "CH", "TW", "TH", "TR", "UA", "AE", "GB", "US", "VN" ], "enumTitles": [ "Any (fastest)", "Argentina", "Australia", "Austria", "Bangladesh", "Belgium", "Brazil", "Canada", "Chile", "Colombia", "Czechia", "Denmark", "Egypt", "Finland", "France", "Germany", "Greece", "Indonesia", "Ireland", "Israel", "Italy", "Japan", "Kenya", "Malaysia", "Mexico", "Morocco", "Netherlands", "New Zealand", "Nigeria", "Norway", "Pakistan", "Peru", "Philippines", "Poland", "Portugal", "Romania", "Saudi Arabia", "Singapore", "South Africa", "South Korea", "Spain", "Sweden", "Switzerland", "Taiwan", "Thailand", "Turkey", "Ukraine", "United Arab Emirates", "United Kingdom", "United States", "Vietnam" ], "title": "Search from country", "type": "string" }, "searchDepth": { "default": "standard", "description": "'Standard' runs one search per account and reads every page TikTok returns. 'Deep' adds searches by plain handle, display name and #handle, a most-liked pass, several date ranges and the Photo tab, then merges them without duplicates. Deep finds noticeably more mentions but takes a few minutes per account. Set the run memory to at least 2048 MB for deep search.", "editor": "select", "enum": [ "standard", "deep" ], "enumTitles": [ "Standard (fast)", "Deep (more mentions, slower)" ], "prefill": "standard", "title": "Search depth", "type": "string" }, "sortBy": { "default": "relevance", "description": "How saved posts are ordered for each account. 'Most liked' and 'Newest first' look at every post found before keeping the top ones.", "editor": "select", "enum": [ "relevance", "mostLiked", "newest" ], "enumTitles": [ "Most relevant (TikTok's order)", "Most liked first", "Newest first" ], "title": "Order of results", "type": "string" }, "usernames": { "description": "Brand or creator accounts whose mentions you want. Type a handle (nike), a handle with @ (@nike) or paste a profile link (https://www.tiktok.com/@nike). One account per line; duplicates are merged.", "editor": "stringList", "example": [ "nike", "@gymshark", "https://www.tiktok.com/@sephora" ], "prefill": [ "billieeilish" ], "title": "TikTok accounts to track", "type": "array" } }, "required": [ "usernames" ], "schemaVersion": 1, "title": "TikTok Verified Mention Tracker input", "type": "object" }