Skip to main content
GET
/
v1
/
scrape
/
tiktok
/
videos
/
popular
Popular Videos
curl --request GET \
  --url https://api.sociavault.com/v1/scrape/tiktok/videos/popular \
  --header 'X-API-Key: <api-key>'
{
  "success": true,
  "credits_remaining": 100,
  "pagination": {
    "has_more": true,
    "limit": 10,
    "page": 1,
    "total_count": 500
  },
  "videos": [
    {
      "country_code": "US",
      "cover": "https://p16-sign-va.tiktokcdn.com/...",
      "duration": 28,
      "id": "7581969577765014797",
      "item_id": "7581969577765014797",
      "item_url": "https://www.tiktok.com/@mnm_pipi/video/7581969577765014797",
      "region": "United States",
      "title": "we can't believe we are the top artist of 2025..."
    }
  ]
}
💳 1 credit per request

Authorizations

​
X-API-Key
string
header
required

API key for authentication. Format: sk_live_xxxxxxxxxxxxx

Get your API key from the Dashboard.

Query Parameters

​
period
enum<integer>

Time period in days (7 or 30)

Available options:
7,
30
Example:

7

​
page
integer

Page number

Example:

1

​
orderBy
enum<string>

Sort videos by likes, views (hot), comments, or reposts

Available options:
like,
hot,
comment,
repost
Example:

"hot"

​
countryCode
enum<string>

Country code to get popular videos from

Available options:
AU,
BR,
CA,
EG,
FR,
DE,
ID,
IL,
IT,
JP,
MY,
PH,
RU,
SA,
SG,
KR,
ES,
TW,
TH,
TR,
AE,
GB,
US,
VN
Example:

"US"

Response

Successful response

​
success
boolean
Example:

true

​
credits_remaining
integer
Example:

100

​
pagination
object
​
videos
object[]