The hardware and bandwidth for this mirror is donated by dogado GmbH, the Webhosting and Full Service-Cloud Provider. Check out our Wordpress Tutorial.
If you wish to report a bug, or if you are interested in having us mirror your free-software or open-source project, please feel free to contact us at mirror[@]dogado.de.

| Description | Shorthand | Research API | Hidden API |
|---|---|---|---|
| search videos | tt_search | tt_search_api | tt_search_hidden |
| get video detail (+file) | tt_videos | - | tt_videos_hidden |
| get user videos | tt_user_videos | tt_user_videos_api | tt_user_videos_hidden |
| get user info | tt_user_info | tt_user_info_api | tt_user_info_hidden |
| get comments under a video | tt_comments | tt_comments_api | - |
| get who follows a user | tt_get_follower | tt_user_follower_api | tt_get_follower_hidden |
| get who a user is following | tt_get_following | tt_user_following_api | tt_get_following_hidden |
| get videos a user liked | tt_get_liked | tt_user_liked_videos_api | - |
| get videos a user reposted | tt_get_reposted | tt_user_reposted_api | - |
| get pinned videos of users | tt_get_pinned | tt_user_pinned_videos_api | - |
| get videos in a playlist | tt_playlist | tt_playlist_api | - |
| build query objects | query | (query_and, query_or, query_not) | - |
| get raw post data | - | - | tt_request_hidden |
| retrieve last query/results | last_query, last_comments | - | - |
| authenticate a session | - | auth_research | auth_hidden |
The goal of traktok is to provide easy access to TikTok data. This package once started as an R port of Deen Freelon’s Pyktok Python module (though it is a complete rewrite without Python dependencies). It now covers functions from the secret hidden API that TikTok is using to show/search/play videos on their Website and the official Research API. To learn about both access pathways, you should check out the Research API and Unofficial API vignettes. Since the Research API misses some important features (and since not everyone has access to it) it can often make sense to still use the hidden API that mocks requests from a browser. However, an important disclaimer for the hidden API applies:
This program may stop working suddenly if TikTok changes how it stores its data (see Freelon, 2018).
However, the last times, it was fixed rather quickly (e.g., #12).
You can install the development version of traktok from GitHub with:
# install.packages("remotes")
remotes::install_github("JBGruber/traktok")The research papers and projects below have used traktok to gather their data:
If you have used traktok in your research paper or project, please extend this list through a Pull Request or create an issue And ideally, also cite the package/paper:
To cite traktok in publications use:
Gruber, Johannes B. (2025). traktok — Making TikTok Data
Accessible for Research. SocArXiv.
https://doi.org/10.31235/osf.io/xrgc6_v2
A BibTeX entry for LaTeX users is
@Article{,
title = {traktok — Making TikTok Data Accessible for Research},
author = {Johannes B. Gruber},
year = {2025},
month = {jun},
journal = {SocArXiv},
doi = {10.31235/osf.io/xrgc6_v2},
url = {https://osf.io/xrgc6_v2},
}These binaries (installable software) and packages are in development.
They may not be fully stable and should be used with caution. We make no claims about them.
Health stats visible at Monitor.