Create a batch compliance task

Request to create a batch compliance task

Headers

Body Parameters

Need form-data in Body

Key	Type	Description	Example	Required
file_data	File	A text file that contains video ids or comment ids. The max IDs users can submit is 10,000 per time.		Yes
category	Text	Category that the file contains. Video or comment.	video	Yes

Example

curl --location 'https://open.tiktokapis.com/v2/research/validation_task/create/' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer abcdefg' \
--form 'file_data=@"/****/****/****/test file.txt"' \
--form 'category="video"'

Response

Body

Example

{
    "data": {
        "task_id": 12345678910987654321
    },
    "error": {
        "code": "ok",
        "http_status_code": 200,
        "log_id": "987654321",
        "message": "ok."
    }
}

Get a batch compliance task status

Request to get a batch compliance task status

Headers

Body Parameters

Example

curl --location 'https://open.tiktokapis.com/v2/research/validation_task_status/get/' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer 1234567891011' \
--data '{
    "task_id":12345678910
}'

Response

Body

Example

{
    "data": {
        "task_status": "Completed"
    },
    "error": {
        "code": "ok",
        "http_status_code": 200,
        "log_id": "12345678910",
        "message": "ok."
    }
}

Download a completed batch compliance task

Request to download a batch compliance task

Headers

Body Parameters

Example

curl --location 'https://open.tiktokapis.com/v2/research/validation_task_status/get/' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer 1234567891011' \
--data '{
    "task_id":12345678910
}'

Response

Click Send and Download, a text file with valid IDs will be download automatically.