TikTok verified mentions in n8n
Find TikTok posts that tag a specific creator or brand handle, with each result checked against TikTok's own mention markup so you can tell a real @mention from a caption that merely contains the name.
What this workflow does
Import it and n8n runs the TikTok Verified Mention Tracker Actor on Apify every day at 08:00 with the starter input below. Each row comes back with tracked account, mention type, post, caption and 8 more; repeats with the same postUrl are dropped. A Google Sheets append is included and stays off until you add your sheet. The only credential it needs is your Apify API token.
Read from the workflow file, built for TikTok Verified Mention Tracker version 1.1.5. Updated 2026-11-14.How the rows travel
6 nodes, in the order n8n runs them. The yellow stop is the call to the Apify Actor; the dashed stop is optional.
- Daily trigger Schedule trigger
- Configure input Code
- Run Apify Actor HTTP Request
- Normalize + dedupe Code
- Rows ready No operation
- Google Sheets (optional) Google Sheets, off until you switch it on
From the Short
This workflow is the one the video points to: the number in each video opens this page.
Input
The Configure input node holds the starter input. Change it there; every setting the Actor accepts is listed below.
{
"usernames": [
"billieeilish"
],
"mentionFilter": "all",
"maxResultsPerProfile": 3,
"maxItems": 50
}| Setting | Type | Required | Default | What it does |
|---|---|---|---|---|
| usernames | array | Yes | – | 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). |
| mentionFilter | string | No | taggedOrCaption | 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… One of: taggedOrCaption, tagged, all. |
| excludeOwnPosts | boolean | No | true | Leave out posts published by the tracked account itself, so you only see what other people say about it. |
| datePosted | string | No | anyTime | Only look at posts published in this period. One of: anyTime, past24Hours, pastWeek, pastMonth, past3Months, past6Months. |
| postedAfter | string | No | – | 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. |
| sortBy | string | No | relevance | How saved posts are ordered for each account. 'Most liked' and 'Newest first' look at every post found before keeping the top ones. One of: relevance, mostLiked, newest. |
| minPlayCount | integer | No | – | Skip posts with fewer views than this. Leave empty to keep posts of any size. |
| searchDepth | string | No | standard | '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… One of: standard, deep. |
| searchCountry | string | No | any | 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). 51 choices. |
| followRelatedVideos | boolean | No | false | 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). |
| maxResultsPerProfile | integer | No | 50 | 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'. |
| maxItems | integer | No | – | Optional limit across all accounts in this run. Leave empty for no overall limit. |
| downloadVideos | boolean | No | false | Download each saved video into this run's key-value store and add a permanent link to it (downloadedVideoUrl). |
| addPostCountry | boolean | No | false | 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. |
What each row holds
Every field the Actor returns stays in the row (12 in its dataset schema). Normalize + dedupe trims text, drops empty fields, removes repeats with the same postUrl and adds _source and _scrapedAt. The main fields:
| Field | What it is |
|---|---|
| targetUsername | Tracked account |
| mentionType | Mention type |
| postUrl | Post |
| caption | Caption |
| createdAt | Posted |
| author.username | Posted by |
| author.followerCount | Author followers |
| playCount | Views |
| likeCount | Likes |
| commentCount | Comments |
| shareCount | Shares |
| postType | Type |
What the first run costs
With the starter input (maxItems = 50) a first run costs about $0.45 on the Apify Free plan: $0.40 to start the run at 4 GB of memory and $0.05 for the results, plus platform usage.
The Actor lists $0.99 per 1,000 results; its catalogue page breaks the price down by Apify plan. The Apify Free plan includes $5 of usage a month.
The Actor behind it
TikTok Verified Mention Tracker: Find TikTok posts that tag a specific creator or brand handle, with each result checked against TikTok's own mention markup so you can tell a real @mention from a caption that merely contains the name.
The same job from an AI agent
The matching agent skill gives Claude Code, Codex, Cursor and other agents the same Actor, input and fields. Install it in one line:
npx skills add https://scraperfinder.com --skill tiktok-verified-mention-tracker The tikTok verified mentions skill, with manual install and run steps
Questions people ask
How do I import this workflow into n8n?
Copy https://scraperfinder.com/n8n/tiktok-verified-mention-tracker.json. In n8n, open a new workflow, click the three-dot menu, choose Import from URL and paste it. Or download the JSON file and use Import from File; both give the same 6 nodes.
Do I need an Apify account?
Yes. The workflow calls the TikTok Verified Mention Tracker Actor through the Apify API with your own token, and each run is billed to your Apify account. The Free plan includes $5 of usage a month.
What does a run cost?
With the starter input (maxItems = 50) a first run costs about $0.45 on the Apify Free plan: $0.40 to start the run at 4 GB of memory and $0.05 for the results, plus platform usage. The Actor's Store page shows the current price.
Can I change what it collects?
Yes: edit the input object in the Configure input node. The Actor takes 14 settings; the table on this page lists each one with its default. Raise maxItems once the first rows look right.
Does it work without Google Sheets?
Yes. The rows wait in the Rows ready node, so you can connect any other node there: a database, Airtable, a webhook or an email. The Google Sheets node is only one option.
Workflow updated 2026-11-14