Documentation Index
Fetch the complete documentation index at: https://docs.mindcase.co/llms.txt
Use this file to discover all available pages before exploring further.
$1.9 / 1k videos
Extract TikTok videos from a list of hashtags — URLs, likes, plays, music, creator data
Endpoint
POST /api/v1/agents/tiktok/hashtag/run
Parameters
List · TikTok hashtags to scrape, with or without the # symbol.
Number · Posts per hashtag. Use 0 for all (TikTok caps each hashtag at ~800).
Response columns
| Field | Display name | Type |
|---|
searchedHashtag | Searched Hashtag | text |
videoUrl | Video URL | url |
caption | Caption | text |
posted | Posted | text |
hashtagTotalViews | Hashtag Total Views | number |
plays | Plays | number |
likes | Likes | number |
comments | Comments | number |
shares | Shares | number |
saves | Saves | number |
reposts | Reposts | number |
authorUrl | Author URL | url |
authorUsername | Author Username | text |
authorName | Author Name | text |
authorAvatar | Author Avatar | url |
authorFollowers | Author Followers | number |
authorVerified | Author Verified | boolean |
videoCover | Video Cover | url |
durationS | Duration (s) | number |
height | Height | number |
width | Width | number |
definition | Definition | text |
song | Song | text |
artist | Artist | text |
originalAudio | Original Audio | boolean |
topHashtag | Top Hashtag | text |
effect | Effect | text |
isAd | Is Ad | boolean |
pinned | Pinned | boolean |
slideshow | Slideshow | boolean |
sponsored | Sponsored | boolean |
language | Language | text |
Example
curl -X POST https://api.mindcase.co/api/v1/agents/tiktok/hashtag/run \
-H "Authorization: Bearer mk_live_abc123def456" \
-H "Content-Type: application/json" \
-d '{
"params": {
"hashtags": [
"fyp"
],
"resultsPerPage": 10
}
}'
Example response
{
"job_id": "job_7f3a2b1c",
"status": "completed",
"data": [
{
"searchedHashtag": "fyp",
"videoUrl": "https://www.tiktok.com/@biteswithesther/video/7540823123629821215",
"caption": "why spend $8 on a brownie when you can spend $30 on ingredients and make 8 \ud83e\udd23\ud83e\udd70\n\ndubai chocolate brownie recipe: \n1 box brownie mix (prepare according to box) \n8 oz kataifi \n3 tbsp unsalted butter \n8 oz jar pistachio cream \n\u00bc cup tahini\n1 \u00bd cup chocolate \n\n#dubaichocolate #dubaichocolatebrownie #viralrecipe #trending #fyp ",
"posted": "2025-08-21T00:05:19.000Z",
"hashtagTotalViews": 118328000000000,
"plays": 14900000,
"likes": 1600000,
"comments": 7011,
"shares": 242000,
"saves": 416984,
"reposts": 0,
"authorUrl": "https://www.tiktok.com/@biteswithesther",
"authorUsername": "biteswithesther",
"authorName": "biteswithesther",
"authorAvatar": "https://p16-common-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/64f5a978831dc4f00d693d23d4874e23~tplv-tiktokx-cropcenter:720:720.jpeg?dr=9640&refresh_token=34aa95e0&x-expires=1777874400&x-signature=4lIzQ81djZp3y9WNNtYzN5d7ZPo%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=useast8",
"authorFollowers": 469600,
"authorVerified": false,
"videoCover": "https://p16-common-sign.tiktokcdn-us.com/tos-useast8-p-0068-tx2/o4ImIEE4RY6pAFDoSFGzfY0fVI8EREDAVLmsBx~tplv-tiktokx-origin.image?dr=9636&x-expires=1777874400&x-signature=KGmJDpqXRhnmykBJ1tDfzTZaiws%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=useast8",
"durationS": 136,
"height": 1024,
"width": 576,
"definition": "540p",
"song": "original sound",
"artist": "biteswithesther",
"originalAudio": true,
"topHashtag": null,
"effect": null,
"isAd": false,
"pinned": false,
"slideshow": false,
"sponsored": false,
"language": "en"
}
]
}
