TikTok Profile Mention Scraper

Find public TikTok videos that @mention a creator or brand profile — not the profile's own posts. Paste usernames or profile URLs; each dataset row includes the video URL, caption, author, engagement, and whether TikTok's structured caption data confirms the exact account ID.

TikTok is a trademark of its owner. This independent Actor is not affiliated with, associated with, or endorsed by TikTok.

Best fit for this Actor

• Brand monitoring for videos that tag your TikTok account
• Influencer deliverable checks before paying a creator
• UGC sourcing and campaign mention tallies
• Competitor watching — who is tagging a rival brand

When you already have the target handles and need their own posts next, continue with TikTok Profile Posts Scraper. When a mention video URL is known and you need comment threads, continue with TikTok Video Comments Scraper. For the same job on Instagram photo-tags, continue with Instagram Tagged Posts Scraper.

Practical scenario

A brand social team pastes gymshark with maxResultsPerProfile: 3 and onlyVerifiedMentions: true. The Actor resolves the account ID, searches public TikTok keyword results for @gymshark, keeps only posts whose caption entities link that ID (and skips Gymshark's own videos), then writes three billed mention rows with author handles and like/play counts for sponsorship review.

Quick start input

{
  "usernames": ["gymshark"],
  "maxResultsPerProfile": 3,
  "onlyVerifiedMentions": true
}

Input reference

Field	Type	What it controls
usernames	array	Required handles or profile URLs. Example: gymshark.
maxResultsPerProfile	integer	Cap per profile (1–200). Prefill 3 for quality tests.
maxSearchPages	integer	Keyword-search pagination safety limit (default 5).
onlyVerifiedMentions	boolean	Default true — only ID-confirmed tags. Set false to also keep caption-text @handle hits.
onlyVideosNewerThan	string	Optional YYYY-MM-DD or 7 days / 2 months.
includeAuthorStats	boolean	Include author follower/following when available.
providerOrder	enum	Diagnostic provider pin; default scrapecreators-first.

What data you receive

One dataset item is one public mention video.

{
  "videoId": "7545933721589910798",
  "videoUrl": "https://www.tiktok.com/@fitcreator/video/7545933721589910798",
  "caption": "New drop with @gymshark code SAVE10",
  "authorUsername": "fitcreator",
  "diggCount": 12500,
  "playCount": 250000,
  "matchType": "verified",
  "isVerifiedMention": true,
  "inputUsername": "gymshark",
  "provider": "scrapecreators",
  "scrapedAt": "2026-09-21T12:00:00.000Z"
}

Field	Meaning
matchType	verified = TikTok text_extra user ID match; caption_text = caption @handle only
isVerifiedMention	True when the structured caption entity links the target account
authorUsername	Who posted the mention (never the target when filters work)
provider	scrapecreators, sociavault, or google

OUTPUT and RUN_SUMMARY in the default key-value store hold outcome, itemsPushed, and cost estimates.

Coverage contract

• Discovery uses public keyword search (and optional Google) for indexed videos that tag a handle.
• Default mode bills ID-verified mentions. Set onlyVerifiedMentions: false when you also want caption-text @handle hits.
• The target's own videos are filtered out of results.
• Known public handle with zero matching public mentions → VALID_EMPTY (unbilled).
• Empty / reserved / non-TikTok input → INVALID_INPUT.
• Total provider outage with zero rows → UPSTREAM_FAILED.

Pricing

Pay per event + platform usage pass-through:

• apify-actor-start: $0.00005
• mention-found: $0.008 per saved mention video

Invalid input and fully empty verified searches are not charged the mention event. See the Actor Pricing tab for the live table.

How to use

1. Open the Actor in Apify Console and paste one or more TikTok handles.
2. Keep onlyVerifiedMentions: true for sponsorship-grade matches.
3. Run, then export the dataset as JSON/CSV or read it from the API/MCP.

API example

curl "https://api.apify.com/v2/acts/khadinakbar~tiktok-profile-mention-scraper/runs?token=YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"usernames":["gymshark"],"maxResultsPerProfile":3,"onlyVerifiedMentions":true}'

Agent prompt card

Use khadinakbar/tiktok-profile-mention-scraper with usernames: ["brand"], maxResultsPerProfile: 5, onlyVerifiedMentions: true. Read dataset rows for videoUrl, authorUsername, matchType, and isVerifiedMention. Check RUN_SUMMARY.outcome before trusting empty results.

Best results tips

• Prefer brand/creator handles that get tagged often (gymshark, major retailers).
• Raise maxSearchPages only when a first page returns few verified hits.
• Pair mention discovery with TikTok Profile Scraper when you need the target's follower counts.

Builder's note

While wiring this Actor we live-probed ScrapeCreators GET /v1/tiktok/search/keyword with trim=false and confirmed text_extra type-0 rows carry the exact user_id of the tagged account (for example Gymshark’s resolved ID). That is why default billing requires ID verification instead of billing every caption that merely contains the word “gymshark”. With trim=true those entities disappear — keep trim off in production.

Legal / responsible use

Use only for public data and lawful brand-safety, marketing, or research workflows. Respect TikTok's terms and applicable privacy laws. Do not use this Actor to harass people or scrape private content.

Support

Open an Issue on the Actor page with the run ID and input (no secrets). After mention discovery, continue to TikTok Profile Posts Scraper for the target’s own grid, TikTok Video Comments Scraper for commenters on a found video, or Instagram Tagged Posts Scraper for the same UGC job on Instagram.