TikTok Videos Popular API
Scrape TikTok Videos Popular data with one API call. Returns the videos TikTok itself ranks at the top of its Top Videos board for a market over the last 7 or 30 days, sorted by views, engagement or 6-second views. Each row is a video: `id`, `url`, the caption at `content.text`, the cover and a video file URL (signed, expires within hours), the creator at `author.username` / `author.display_name` with `ext.author_id` and `ext.author_followers`, the upload time at `published_at`, and lifetime views at `engagement.views`. What the board says about it is on `ext.trend`: `rank`, `period_views` (views inside the window), `organic_views`, `engagement_rate`, `six_second_view_through_rate` and TikTok's `content_tags`. **Markets: TikTok publishes this board for US, JP, VN, TH and ID only.** Any other market, Germany included, is refused with a 400 at no charge; for those markets use `/v1/tiktok/hashtags/popular`, which covers 27. **The board carries no like, comment or share counts and no duration**, so those leaves are null rather than estimated. It includes paid and branded posts; `organic_views` is the only paid-versus-organic signal TikTok gives. A logged-out reader of TikTok's page sees the top four, and ranks 1 to 4 were checked against it; deeper ranks follow TikTok's order as served. **Pricing is metered at 25 credits per board plus 1 credit per video returned** (20 videos = 45 credits), because each read of the board has a fixed cost. An empty board costs nothing.
Last updated September 2026Maintained by the SocialCrawl team
Returns TikTok's Top Videos board for the US, Japan, Vietnam, Thailand or Indonesia over 7 or 30 days: each video's rank, lifetime and window views, organic views, engagement rate and creator.
Use it for the videos TikTok ranks highest in those five markets. Other markets have no board and return a free 400; use hashtags/popular there.
Searching 65 platforms in parallel
What can you do with the Videos Popular API?
The Videos Popular endpoint gives you structured TikTok data with computed fields in a single request. No scraping infrastructure to build or maintain.
Example Request
curl -H "x-api-key: YOUR_API_KEY" \
"https://www.socialcrawl.dev/v1/tiktok/videos/popular?countryCode=US&period=7&orderBy=views"import requests
response = requests.get(
"https://www.socialcrawl.dev/v1/tiktok/videos/popular",
params={
'countryCode': 'US',
'period': '7',
'orderBy': 'views',
},
headers={"x-api-key": "YOUR_API_KEY"},
)
data = response.json()const response = await fetch(
"https://www.socialcrawl.dev/v1/tiktok/videos/popular?countryCode=US&period=7&orderBy=views",
{
headers: { "x-api-key": "YOUR_API_KEY" },
},
);
const data = await response.json();Parameters
| Parameter | Required | Description |
|---|---|---|
| countryCode | No | Market: US, JP, VN, TH or ID, the only markets TikTok publishes this board for. Defaults to US. (US | JP | VN | TH | ID) |
| period | No | Window in days: 7 or 30. Defaults to 7. (7 | 30) |
| orderBy | No | How TikTok ranks the board: views (the default), engagement, or six_second_views. (views | engagement | six_second_views) |
| limit | No | How many videos to return, 1-20, default 20. |
What does the TikTok Videos Popular API return?
This example shows the endpoint's response shape and fields. Values are illustrative; this is not a live capture.
Example response
{
"success": true,
"platform": "tiktok",
"endpoint": "/v1/tiktok/videos/popular",
"data": {
"items": [
{
"post": {
"id": "7637623185378200845",
"url": "https://www.tiktok.com/@linguamarina/video/7637623185378200845",
"content": {
"text": "PDFs in 2016: you send a file. PDFs in 2026: you send an experience. #AdobeAcrobatPartner",
"media_urls": "https://v16m-default.tiktokcdn-us.com/ffcc07a41d17debbb4370d167d69be97/6aa64689/video/tos/useast5/tos-useast5-pve-0068-tx/oguJeAponvOogH25FxWQAOM1RfAGJfRRgf8cIJ/",
"thumbnail_url": "https://p16-common-sign.tiktokcdn-us.com/tos-useast5-p-0068-tx/o8GJOFO5A6efHrf6dnvAAkIe7AIRQAwIDJSMEA~tplv-photomode-zoomcover-tcm:720:720.jpeg",
"duration_seconds": null
},
"author": {
"username": "linguamarina",
"display_name": "Silicon Valley Girl",
"avatar_url": "https://p16-common-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/57f759b02de679189cf842ebf9341aa7~tplv-tiktokx-cropcenter:300:300.jpeg",
"verified": null
},
"engagement": {
"views": 153672528,
"likes": null,
"comments": null,
"shares": null,
"saves": null
},
"flags": {
"nsfw": null,
"spoiler": null,
"pinned": null,
"deleted": false
},
"published_at": "2026-05-08T20:38:56.000Z",
"ext": {
"author_id": "6844415658239721478",
"author_followers": 3007554,
"trend": {
"rank": 1,
"country_code": "US",
"period_days": 7,
"order_by": "views",
"period_views": 62318158,
"organic_views": 9531351,
"engagement_rate": 0.001632878815192195,
"six_second_view_through_rate": 0.02756890176226899,
"content_tags": []
}
}
},
"computed": {
"engagement_rate": null,
"language": "en",
"content_category": "other",
"estimated_reach": 184407034
}
},
{
"post": {
"id": "7680228073656093966",
"url": "https://www.tiktok.com/@iamcardib/video/7680228073656093966",
"content": {
"text": "Y’all know I don’t play about my @Chipotle! The official Bardi Bowl + the new Chili Lime Chips are officially in the Chipotle app. Get into it!!!!!",
"media_urls": "https://v16m-default.tiktokcdn-us.com/7414aae302c9b68da8a6ab51b6fc7c5f/6aa646b8/video/tos/useast5/tos-useast5-ve-0068c004-tx/osZVRauhqISWETDepBlFk2aEEwDQ9qAOAgfVx8/",
"thumbnail_url": "https://p16-common-sign.tiktokcdn-us.com/tos-useast5-p-0068-tx/oowVAZglfAE8caCaBDRq8tBupEDSFEmO9a5I3e~tplv-photomode-zoomcover-tcm:720:720.jpeg",
"duration_seconds": null
},
"author": {
"username": "iamcardib",
"display_name": "Cardi B",
"avatar_url": "https://p19-common-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/dcd32ba414395bcdd66310eea46e9625~tplv-tiktokx-cropcenter:300:300.jpeg",
"verified": null
},
"engagement": {
"views": 131166904,
"likes": null,
"comments": null,
"shares": null,
"saves": null
},
"flags": {
"nsfw": null,
"spoiler": null,
"pinned": null,
"deleted": false
},
"published_at": "2026-08-31T16:07:59.000Z",
"ext": {
"author_id": "7506219246691729454",
"author_followers": 36236761,
"trend": {
"rank": 2,
"country_code": "US",
"period_days": 7,
"order_by": "views",
"period_views": 54048688,
"organic_views": 16137343,
"engagement_rate": 0.008164120468567156,
"six_second_view_through_rate": 0.07433548136286997,
"content_tags": []
}
}
},
"computed": {
"engagement_rate": null,
"language": "en",
"content_category": "other",
"estimated_reach": 157400285
}
}
],
"total": null
},
"credits_used": 27,
"credits_remaining": 9973,
"request_id": "req-a1b2c3d4e5f6"
}Illustrative fixture for the documented response shape. Values are examples, not a production capture.
How does the TikTok Videos Popular API work?
Send a GET request with your API key and get back clean, structured JSON in our unified schema. Supported computed fields are populated when the source provides the required inputs.
Method
GET
Response
JSON
How do you scrape social media data in seconds?
The fastest social media scraping API for developers. Scrape profiles, posts, comments, and analytics from 65 platforms covering 10B+ monthly active users.
One schema, every platform
Query 65 platforms with identical response structures. Write your integration once.
Computed fields, not just scraped
When an endpoint supports these metrics and the source provides the required inputs, the normalized record includes engagement_rate, estimated_reach, content_category, and language. Ready to use.
See your data before you code
Visual Data Explorer. Paste any URL, get rich result cards, sortable tables, CSV export.
import requests
response = requests.get(
'https://www.socialcrawl.dev/v1/tiktok/profile',
params={'handle': 'charlidamelio'},
headers={'x-api-key': 'sc_YOUR_API_KEY'}
)
data = response.json(){
"success": true,
"platform": "tiktok",
"data": {
"author": {
"username": "charlidamelio",
"followers": 152400000
},
"engagement": {
"likes": 12400000000,
"engagement_rate": 0.087
},
"metadata": {
"language": "en",
"content_category": "lifestyle"
}
}
}Ready to scrape TikTok Videos Popular data?
Get your API key and start pulling TikTok data in under 60 seconds.
