Skip to main content
TikTok for Developers

Docs

Frequently Asked Questions

    What data is available as part of the Research Tools?

More information on our Research Tools can be found here. Once approved for access to the Research Tools, researchers can access public data on:

  • Videos: Videos configured to "Everyone" for who can watch, and for such videos, the total number of likes, total number of comments, voice-to-text, subtitles, the time of creation and video length.
  • Comments: Comment text, and total number of likes, replies, and the time the comment was posted.
  • Accounts: Bios, profile pictures, country of registration (for example, a region code such as IE), the usernames and profile names of the account's followers and the users the account follows, and the total number of users who follow the account and who are followed by the account.

For detailed info on the data returned via our tools, check out the codebook.

    How do I know if I qualify for access to TikTok's Research Tools ?

Applicants must fulfill the following criteria to qualify for access:

  • Be located in an eligible region and be affiliated with an eligible organization:
    • Non-profit academic institutions in the US, EEA, UK or Switzerland; or
    • Not-for-profit research institution, organization, association, or body in the EU. We are currently beta testing this service with select researchers in the US, UK, Switzerland, Norway, Iceland and Liechtenstein.
  • Have demonstrable experience and expertise in the research area specified in the application
  • Be independent from commercial interests and be able to conduct research on a not-for-profit basis pursuant to a public-interest mission
  • Disclose the funding of the research
  • Provide a clearly defined research proposal and show the access requested is needed for, and proportionate to, the purpose of that research
  • Commit to fulfilling data security and confidentiality requirements (including taking steps to protect personal data)
  • Be able to provide evidence that the research went through an ethical research review
  • Be prepared to uphold the requirements set out in the TikTok Research Tools Terms of Service

    How do I apply for Research Tools access?

If you meet the eligibility criteria outlined above and have prepared a research proposal, click here to apply.

    Can I work with a group of researchers to collaborate on a research topic? How do I ensure we all get access to the Research Tools in order to collaborate on our approved project?

We support lab-level access to Research Tools. The application form should be submitted by the project's principal researcher. Once the application is approved, the principal researcher can log in and view the approved "Organization" on the TikTok for Developers (TT4D) home page. Here, the principal researcher will have the ability to manage access, including adding and removing collaborators.

The principal researcher can add up to 9 collaborators to work together on a research topic. It is preferable that the principal researchers submit the details of all anticipated collaborators during the application process. TikTok will review any collaborators that are invited to join an approved research project prior to granting them access. Further, it is the responsibility of the principal researcher to remove and revoke access to collaborators who are no longer working on the approved research project.

If the collaborators are from a different research entity, an application should be submitted with a list of collaborators for each research entity.

The collaborators need to ensure that they have setup their TT4D account in advance prior to getting an invite.

The approved data limits will be shared across the organization.

    When will TikTok's Research Tools be available in my country?

TikTok is actively working to expand eligibility to additional regions. Please check this page for updates.

    I am a creator, advertiser, or commercial user. Am I eligible for access to the Research Tools?

No. Click here to learn more about our other API access opportunities.

    What are the daily quota limits? Can I request an increase in the quota limit?

Currently, the daily limit is set at 1000 requests per day, allowing you to obtain up to 100,000 records per day across our APIs. (Video and Comments API can return 100 records per request). The daily quota gets reset at 12 AM UTC.

For the Followers and Following lists API, you can obtain up to 2M records per day by making up to 20,000 calls per day. You get a maximum of 100 records in each call. The daily quota gets reset at 12 AM UTC.

If you are approved for access to the Virtual Compute Environment (VCE), then you can access up to 5,000 records per day in the "Test Stage".

If you believe a quota limit increase is necessary for your research, please email us at Research-API@tiktok.com. We can't grant exceptions, but we're eager to better understand use cases from the research community to evaluate and take your requests into account for the future.

    I have a developer account with TikTok. Can I start using Research Tools?

Your developer account alone is not sufficient to grant you access to Research Tools. In order to access our Research Tools, you will need to meet our eligibility requirements, submit an application, and be approved for a specific research project.

Research API Usage FAQs

    Why does User API not return responses sometimes even though the user name is accurate?

TikTok's Research API does have some filters. To cite some examples, public data of users under the age of 18 and data from Canada is not returned in the responses

    Why is my access token invalid?

Access tokens are set to expire every two hours. If you experience an invalid token error within two hours of generating it, please submit a support ticket to us with your token and client key, and we will investigate the issue.

    Why did I receive a response back with code: "scope_not_authorized" and message: "The user did not authorize the scope required for completing this request?"

This indicates that you have not yet submitted your research application for our review and have not passed the necessary approval evaluations. If you are interested in accessing our Research Tools, visit our Research Toolspage to learn more, check eligibility requirements and apply for access.

    Why is the query video data (view_count, comment_count, like_count, share_count) significantly inaccurate, often showing lower numbers than what is live at the moment?

The User info API only retrieves data for an individual user, so we use online data. However, the video query API searches for the full dataset, so we use archived data instead of the current online data. New videos take up to 48 hours to be added to the search engine, and statistics such as view count and follower count can take up to 10 days to update.