scraper
Back to API docs

Overview

  • Overview

APIs

  • POSTHashtag
  • POSTProduct
  • POSTProduct Reviews
  • POSTTrending Videos
  • POSTUser Profile
  • POSTUser Search
  • POSTVideo Post
  • POSTVideo Transcript
  • POSTVideo Search
  • POSTVideos

TikTok Trending Videos

2 credits

Get the trending TikTok videos.

POST/api/v1/tools/tiktok/trending

Parameters

resultsLimitnumber

Most trending videos to read, from 1 to 1000. Default: 50.

Response Schema

dataobject

TikTok trending videos result

videosobject[]

The trending videos, in the order of the list. Each record has the video fields of the Video Post endpoint (videoId, videoUrl, desc, createTime, video, author, stats, music and more), plus the fields below. A list does not give locationCreated, categories, isAiGenerated, author.createTime or author.seller, so they are empty.

metaobject

Request metadata

toolstring

Tool name (tiktok-trending)

creditsUsednumber

Credits consumed (2)

requestIdstring

Unique request ID

Request

curl -X POST https://scraper.run/api/v1/tools/tiktok/trending \
-H "Authorization: Bearer sc_live_..." \
-H "Content-Type: application/json" \
-d '{
"resultsLimit": 20
}'

Response Example

{
"data": {
"videos": [
{
"type": "video",
"source": "explore",
"videoId": "7340001234567890001",
"videoUrl": "https://www.tiktok.com/@chefmike/video/7340001234567890001",
"desc": "Three-minute pasta #cooking #foodtok",
"createTime": "1709251200",
"categories": [],
"hashtags": [
"cooking",
"foodtok"
],
"mentions": [],
"effects": [],
"captionLanguages": [
"eng-US"
],
"images": [],
"video": {
"duration": 32,
"width": 576,
"height": 1024
},
"author": {
"id": "6812345678901234567",
"uniqueId": "chefmike",
"nickname": "Chef Mike"
},
"stats": {
"views": 1250000,
"likes": 98000,
"comments": 1200,
"shares": 4300,
"saves": 15000,
"reposts": 0
},
"music": {
"id": "7340001234567890999",
"title": "original sound"
}
}
]
},
"meta": {
"tool": "tiktok-trending",
"creditsUsed": 2,
"requestId": "req_abc123"
}
}