Log inStart Free Trial
easyCoexistence Official APIs

TikTok mentions through the API: finding posts and comments that mention an account

TikTok's Mentions API, part of the API for Business, returns the top 1,000 public posts from the past 90 days that @mention a business account in their caption, through GET /business/mention/video/list/, and the top 1,000 comments or replies that mention it, through /business/mention/comment/list/. Both need the biz.brand.insights scope and an account with Advanced Access or a Verified Business Account.

easyCoexistence connects a TikTok account through TikTok's API for Business: Claude, ChatGPT or your own code read its comments and reply to them with dedicated tools and receive its comment events as they arrive, and get_social_credentials gives your own code the token for other API for Business calls, the Mentions endpoints included where TikTok opens them to the account.

1,000

Most mentioned posts /business/mention/video/list/ returns, all public and from the past 90 days, up to 100 per request.

24 to 48 hours

Approximate delay between a mention being made and its availability through the Mentions API.

2 to 3 hours

Latency TikTok gives for the Mentions webhook after a user mentions the business in a caption or comment.

Once a day

How often TikTok recommends calling each Mentions endpoint per account, after the 0 to 7 am UTC refresh.

comment.list

Scope /business/mention/comment/list/ needs beside biz.brand.insights to return comments that mention the account.

Which endpoints does the Mentions API have?

Six read endpoints, each a GET on https://business-api.tiktok.com/open_api/v1.3 with the account's access token in the Access-Token header and its open_id as business_id. Two list mentions, two summarize what mentioned posts say, and two fetch a single mention that a webhook announced:

/business/mention/video/list/Up to 1,000 posts whose caption mentions the account, 100 a page
/business/mention/comment/list/Up to 1,000 comments or replies whose text mentions the account
/business/mention/top_word/list/The 20 keywords that appear most in mentioned posts' captions
/business/mention/top_hashtag/list/The 20 hashtags used most in those captions
/business/mention/video/get/One mentioned post from a webhook event, within 48 hours
/business/mention/comment/get/One comment mention from a webhook event, within 48 hours

Which posts and comments count as mentions?

Those that tag the account's handle with @, in a post's caption or in a comment's text, on a public post, and that pass TikTok's other filters:

  • The post went up within the past 90 days.
  • Its author is not underage or of unknown age: 17 or under counts as underage in Europe, 12 or under in the US and other regions.
  • It ranks among the 1,000 most liked posts, or comments, that mention the handle.
  • The business's own posts that meet these rules count as well.
  • Comments made of the mention alone, with no other text, are ranked lower.

What does an account need before it can use them?

An eligible account, an app with the right permission, the scopes on the token, and a day's wait after the owner authorizes the app:

  • Advanced Access or a Verified Business Account; has_advanced_access on /business/get/ shows which accounts qualify.
  • The Mentions permission on the developer app, listed as Mentions, Content for posts and Mentions, Comment for comments.
  • biz.brand.insights on the access token, plus comment.list for comment mentions.
  • 24 hours after authorization before the first pull, as TikTok's getting-started guide asks.

How do you list posts that mention the account?

With GET /business/mention/video/list/. fields chooses the data, item_id and caption by default, plus create_time, video_link, likes, comments, shares, thumbnail_url, views, reach and creator_handle_name on request. sort_field takes CREATE_TIME, LIKES, COMMENTS or SHARES with sort_type ASC or DESC, number_of_days narrows the 90 days, regions keeps creators from chosen regions, and cursor with has_more pages through the results. views and reach read null below 1,000, and thumbnail links last 48 hours:

Mentioned posts, sorted by likes
curl --get 'https://business-api.tiktok.com/open_api/v1.3/business/mention/video/list/' \
  -H 'Access-Token: <ACCESS_TOKEN>' \
  --data-urlencode 'business_id=<OPEN_ID>' \
  --data-urlencode 'fields=["item_id","video_link","caption","likes","creator_handle_name"]' \
  --data-urlencode 'sort_field=LIKES' \
  --data-urlencode 'number_of_days=30' \
  --data-urlencode 'max_count=100'

{
  "code": 0,
  "message": "OK",
  "request_id": "<REQUEST_ID>",
  "data": {
    "videos": [
      {
        "item_id": "<ITEM_ID>",
        "video_link": "https://www.tiktok.com/@/video/<ITEM_ID>",
        "caption": "<CAPTION>",
        "likes": 243,
        "creator_handle_name": "<HANDLE>"
      }
    ],
    "cursor": 100,
    "has_more": true
  }
}

How do you list comments that mention the account?

With GET /business/mention/comment/list/, whose token needs comment.list as well. By default it returns comment_id and comment_text; item_id, video_link, caption, video_likes, thumbnail_url, commenter_display_name, comment_type, comment_create_time and comment_likes come on request, and comment_type reads COMMENT or REPLY. A page holds 10 unless max_count asks for up to 100, sorted by VIDEO_LIKES, COMMENT_CREATE_TIME or COMMENT_LIKES. Because of TikTok's trust and safety policies, a page can come back short while has_more is still true.

How do you reply to a mention?

Through TikTok's comment reply endpoint. POST /business/comment/reply/create/ takes business_id, video_id set to the item_id from the comment mention, comment_id and a text of up to 1,200 characters, and the reply appears in public under that comment, on whichever post carries it. TikTok's reference names the comment.list.manage scope and the same account requirement for it. Its Mentions reference lists a reply for comment mentions only.

Can mentions arrive by webhook?

Yes. With the Mentions permission, an app calls POST /business/webhook/update/ with event_type BRAND_MENTION, and TikTok then posts brand.mention.event within up to two or three hours of a mention, signed in Tiktok-Signature like its other webhooks. content is a serialized JSON string holding:

  • type_of_event: CREATE, EDIT, or PRIVACY_CHANGE for a change to a post's privacy setting.
  • mention_type: COMMENT for a comment or reply, VIDEO_MENTION for a caption, where comment_id reads 0.
  • video_id, video_create_time, share_url and video_caption, which describe the post.
  • open_id_of_mentioned_user, unique_name_of_mentioned_user, and unique_identifier, a commenter ID that stays the same across APIs.
  • Details follow from /business/mention/video/get/ or /business/mention/comment/get/, within 48 hours of the event.

How often should the Mentions endpoints be called?

Once a day per endpoint and account, after 7 am UTC, is TikTok's advice. The endpoints share the developer app's global rate limits, but TikTok refreshes the previous day's data between midnight and 7 am UTC and calls further pulls within the same day unnecessary. A new mention also takes roughly 24 to 48 hours to reach the list endpoints, which makes the webhook the faster signal.

How do brand hashtags work?

They widen mentions to posts that use hashtags the business chose. POST /business/mention/hashtag/add/ enables up to 10 hashtags per request and 50 per account, taken from the up to 100 that /business/mention/hashtag/verify/list/ suggests or containing the full handle, as #drinktiktok would for @TikTok. An enabled hashtag cannot be removed for seven days, and its posts reach /business/mention/hashtag/video/list/ 24 hours after it is enabled.

What can easyCoexistence do with TikTok mentions?

Hand your own code the account's token: get_social_credentials returns the token and business_id for API for Business paths under business/, business/mention/ among them. TikTok answers when the account and the app meet the requirements above. Mention webhooks stay outside it: easyCoexistence subscribes its app to comment events only and keeps business/webhook/ paths to itself, so BRAND_MENTION events are not forwarded. Comments on the account's own posts, mentions included, still arrive as comment.update events, which set_social_webhook_destination forwards:

Comment mentions and a reply, from your own code
GET https://business-api.tiktok.com/open_api/v1.3/business/mention/comment/list/
  ?business_id=<BUSINESS_ID>
  &fields=["item_id","comment_id","comment_text","commenter_display_name","comment_type"]
  &sort_field=COMMENT_CREATE_TIME&max_count=50
Access-Token: <ACCESS_TOKEN>

POST https://business-api.tiktok.com/open_api/v1.3/business/comment/reply/create/
Access-Token: <ACCESS_TOKEN>
{ "business_id": "<BUSINESS_ID>", "video_id": "<ITEM_ID>", "comment_id": "<COMMENT_ID>", "text": "Thanks for the mention!" }

Common mistakes

  • Calling the Mentions endpoints for an account without Advanced Access. TikTok serves them to accounts with Advanced Access or a Verified Business Account, which has_advanced_access on /business/get/ reports.
  • Pulling mentions just after midnight UTC. TikTok refreshes the previous day's data between midnight and 7 am UTC, so a pull after 7 am sees the whole day.
  • Reading a comment_id of 0 as a comment. In a mention webhook it means the mention is in the post's caption, with mention_type VIDEO_MENTION.
  • Enabling a brand hashtag to try it out. TikTok keeps an enabled hashtag for seven days before it can be removed, and it counts toward the account's 50.
Doing this with EasyCoexistence

US$ 9 to US$ 0.75 per connection per month, falling as you add connections, with the first 3 days free.

easyCoexistence is a multichannel API and MCP server that connects AI agents such as Claude and ChatGPT to WhatsApp, Instagram, TikTok, Facebook and more. On WhatsApp it uses Coexistence: the business keeps using its number in the WhatsApp Business app while the AI works through Meta's official API.

Frequently asked questions

Can the TikTok API find videos that mention my account?

Yes, those that @mention its handle in the caption. /business/mention/video/list/ returns up to 1,000 public posts from the past 90 days, with creator_handle_name naming each creator.

Do private TikTok posts count as mentions?

No. The Mentions API counts public posts from the past 90 days only, and leaves out authors who are underage or of unknown age: 17 or under in Europe, 12 or under in the US and other regions.

How long does a TikTok mention take to show up?

About 24 to 48 hours through the list endpoints, and up to two or three hours through the Mentions webhook.

Can easyCoexistence alert me when my TikTok account is mentioned?

Not as a forwarded event, since it forwards TikTok's comment events and not mention events. Your own code can read mentions on request, with the token from get_social_credentials, where the account qualifies.

Keep reading

Connect your first channel in two minutes.

No platform reviews to wait for. Connect WhatsApp, Instagram, TikTok or another channel, then ask your AI to post, reply or report, and watch it work.

  • 3 days free
  • Cancel any time
  • Official APIs only
  • Monitored 24/7

Verified on