Get started

Welcome to Mentions API! With developers in mind, we make accessing and using our API possible through only a few steps.

What are the criteria for discovering mentioned posts?

To appear in the search results, a post must meet the following requirements: - User age: The post is not posted by a user who is underage or of an unknown age. For users in Europe, an age of 17 or under is considered underage, while for users in the US and other countries or regions, an age of 12 or under is considered underage. - Post visibility: The post must be public. - Lookback period: The post must be posted within the past 90 days. - Mention: The post must explicitly mention (@) the business's handle in the caption. - Rank: The post should be among the top 1000 most liked posts out of all the posts that mention the business's handle.

Note

• Self-mentioned posts, a business's own posts that meet the requirements above, will also appear in the search results.
• After the account authorization is done, you need to wait for 24 hours before pulling mentions data.

Below are the steps needed to take before making your first API call and some useful resources to help you quickly integrate with Mentions API.

Step-by-step workflow

1. Create a TikTok For Business account.
2. Register as a developer.
3. Create a developer app.
4. Authorization.
5. Authentication.
6. Make your first API call.

API endpoints

To learn about available endpoints, see API Reference for Mentions API.

Rate limits

To learn about the rate limits of Accounts API, see Rate limits for Mentions API.