POST /v1/data/tiktok/download/run
Pricing: $0.005 per download ($5.00 per 1,000).
Request
Send the inputs underparams. Only the keys below are accepted; any other key returns 422 invalid_params.
Example
curl -X POST "https://api.mindcase.co/v1/data/tiktok/download/run?wait=true" \
-H "Authorization: Bearer $MINDCASE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"params": {
"urls": [
"https://www.tiktok.com/@billieeilish/video/7050551461734042926",
"https://www.tiktok.com/@mrbeast/video/7582653507375746334",
"https://www.tiktok.com/@cznburak/video/7120985110991604993"
]
}
}'
import os, requests
r = requests.post(
"https://api.mindcase.co/v1/data/tiktok/download/run",
params={"wait": "true"},
headers={"Authorization": f"Bearer {os.environ['MINDCASE_API_KEY']}"},
json={"params": {
"urls": [
"https://www.tiktok.com/@billieeilish/video/7050551461734042926",
"https://www.tiktok.com/@mrbeast/video/7582653507375746334",
"https://www.tiktok.com/@cznburak/video/7120985110991604993"
]
}},
)
job = r.json()
rows = job.get("data", []) # if job["status"] == "running", poll /v1/jobs/{job_id}/results
const r = await fetch("https://api.mindcase.co/v1/data/tiktok/download/run?wait=true", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.MINDCASE_API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({ params: {
"urls": [
"https://www.tiktok.com/@billieeilish/video/7050551461734042926",
"https://www.tiktok.com/@mrbeast/video/7582653507375746334",
"https://www.tiktok.com/@cznburak/video/7120985110991604993"
]
} }),
});
const job = await r.json();
const rows = job.data ?? []; // if job.status === "running", poll /v1/jobs/{job_id}/results
Response fields
Each row indata is one download, keyed by these fields.
| Field | Name | Type |
|---|---|---|
postUrl | Post URL | url |
videoId | Video ID | text |
author | Author | object |
caption | Caption | text |
postedDate | Posted Date | date |
durationS | Duration S | number |
downloadUrl | Download URL | url |
downloadUrlExpiresAt | Download URL Expires At | datetime |
fileSizeBytes | File Size Bytes | number |
resolution | Resolution | text |
videoWidth | Video Width | number |
videoHeight | Video Height | number |
isSlideshow | Is Slideshow | boolean |
photoSlideshowImageUrls | Photo Slideshow Image URLs | array |
thumbnail | Thumbnail | image |
audioUrl | Audio URL | url |
sound | Sound | object |
views | Views | number |
likes | Likes | number |
comments | Comments | number |
shares | Shares | number |
saves | Saves | number |
country | Country | text |
hashtags | Hashtags | object_array |
mentions | Mentions | object_array |
Example response
Abridged: long text and lists are shortened.{
"job_id": "7f3a1c2e-0b9d-4c55-9a51-3f2e8d1b6a40",
"agent": "tiktok/download",
"status": "completed",
"row_count": 1,
"truncated": false,
"data": [
{
"isSlideshow": false,
"author": {
"username": "billieeilish",
"profileUrl": "https://www.tiktok.com/@billieeilish",
"displayName": "billieeilish",
"avatar": null,
"bio": "\"HIT ME HARD AND SOFT\" THE ALBUM\nOUT NOW",
"verified": true,
"followers": 74577630,
"following": 80,
"region": "US",
"tiktokId": "6879693940111901701"
},
"audioUrl": "https://sf16.tiktokcdn-us.com/obj/tos-alisg-ve-2774/oc018avE73ZCdY9QdBFmCF5DgCQjqBnffoOtOs",
"resolution": "540p",
"fileSizeBytes": 2327756,
"videoWidth": 576,
"saves": 482559,
"sound": {
"musicId": "6929763762322343937",
"title": "These Days",
"author": "Nico",
"durationS": 60,
"isOriginal": false
},
"postedDate": "2022-01-07T19:40:36Z",
"downloadUrl": "https://v16m.tiktokcdn-us.com/7c359302c9b7075de9bae7332bfe61b4/6aee26ec/video/tos/useast5/tos-useast5-pve-0068-tx/71f099ea003447c6818b23bf70b4a4dc/?a=1233&bt...",
"country": "US",
"shares": 69474,
"postUrl": "https://www.tiktok.com/@billieeilish/video/7050551461734042926",
"downloadUrlExpiresAt": "2026-11-06T19:13:18Z",
"likes": 27701931,
"views": 204876728,
"photoSlideshowImageUrls": [],
"videoId": "7050551461734042926",
"comments": 196966,
"mentions": [],
"videoHeight": 1024,
"thumbnail": "https://p19-common-sign.tiktokcdn-us.com/tos-useast5-p-0068-tx/0c47b0f4690542cbabdc299cc939e00f_1641584437~tplv-tiktokx-shrink-aq:360:360:q75.heic?dr=11731&r...",
"hashtags": [],
"durationS": 29.77,
"caption": "can’t be good at everything"
}
]
}
Related APIs
For engagement data usetiktok/posts.