Docs

Reposted Videos

Request

HTTP URL	https://open.tiktokapis.com/v2/research/user/reposted_videos/
HTTP Method	POST
Scopes	research.data.basic (required)

Headers

Key	Type	Description	Example	Required
Authorization	string	The client access token obtained from /v2/oauth/token/	Bearer clt.example12345Example12345Example	Yes
Content-Type	string	The original media type of the resource	application/json	Yes

Query Parameters

Key

Type

Description

Example Value

Required

fields

string

Field names for desired data to be returned. It is a comma separated list.

See Video Object below for a full list of values.

Complete list: id, create_time, username, region_code, video_description, music_id, like_count, comment_count, share_count, view_count, hashtag_names, is_stem_verified, favourites_count, video_duration, hashtag_info_list, video_mention_list, video_label

Yes

Body

Key	Type	Description	Example Value	Required
username	string	The username as the unique identifier	"test_username"	Yes
max_count	int64	The maximum number of reposted videos returned in a single response. Default is 20, max is 100. It is possible that the API returns fewer videos than the max count due to content moderation outcomes, videos being deleted, marked as private by users, or more.	20	No
cursor	int64	Retrieve video results starting from the specified index	15	No

Example

curl --location 'https://open.tiktokapis.com/v2/research/user/reposted_videos/?fields=id,create_time,region_code,music_id,like_count,comment_count,share_count,view_count,hashtag_names' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer clt.test123test123temp123test123' \
--data '{
    "username": "test_username",
    "max_count": 6,
    }'

Response

Body

Key	Type	Description
data	RepostedVideosData	The returned list of reposted video objects
error	ErrorStructV2	Error object

RepostedVideosData

Key	Type	Description
user_reposted_videos	list<Video>	A list of video objects that match the query
cursor	int64	Retrieve reposted videos starting from the specified index
has_more	bool	Whether there are more reposted videos or not

Video Object

Field Name	Type	Description
"id"	int64	The unique identifier of the TikTok video
"create_time"	int64	UTC Unix epoch (in seconds) of when the TikTok video was posted
"username"	string	The username as the unique identifier of the video creator
"region_code"	string	A two-digit code for the country where the video creator registered their account
"video_description"	string	The description of the reposted video
"music_id"	int64	The music ID used in the video
"like_count"	int64	The number of likes the video has received
"comment_count"	int64	The number of comments the video has received
"share_count"	int64	The number of shares the video has received
"view_count"	int64	The number of views the video has received
"hashtag_names"	list<string>	The list of hashtags used in the video
"hashtag_info_list"	Struct	"hashtag_id" and "hashtag_description". Returns all the unique hashtag_ids for each hashtag_name and a "hashtag_description" when one exists
"video_mention_list"	list<string>	Returns other users tagged in a video
"video_label"	Struct	Returns any information and labels associated with a video
"video_duration"	int64	The duration of the video, in seconds
"is_stem_verified"	bool	Whether the video has been verified as being high quality STEM content
favorites_count	int64	The number of favorites that a video receives

Example

{
    "data": {
        "cursor": 7,
        "has_more": true,
        "reposted_videos": [
            {
                "comment_count": 64,
                "create_time": 1706442860,
                "id": 7777777777777777777,
                "like_count": 11169,
                "music_id": 1111111111111111111,
                "region_code": "MD",
                "share_count": 27,
                "view_count": 148105
            },
            {
                "like_count": 717,
                "share_count": 4,
                "comment_count": 12,
                "hashtag_names": [
                    "fyp",
                    "example",
                    "trainingseason",
                    "newsong"
                ],
                "music_id": 9999999999999999999,
                "region_code": "DO",
                "view_count": 56416,
                "create_time": 1706355306,
                "id": 3333333333333333333
            }
        ]
    },
    "error": {
        "code": "ok",
        "message": "ok",
        "log_id": "202402000999900909990909090999999"
    }
}