SocialScrape
Get an API key
Popular TikTok videos API
  1. Docs
  2. TikTok
  3. Popular TikTok videos API

Popular TikTok videos API

Videos from TikTok's Explore feed, the nearest public list to 'popular' (the Creative Center ranking behind ScrapeCreators' endpoint needs a login).

GET /v1/tiktok/videos/popular

GET /v1/tiktok/videos/popular

Videos from TikTok's Explore feed, the nearest public list to 'popular' (the Creative Center ranking behind ScrapeCreators' endpoint needs a login). period and sort are accepted for compatibility and not applied; category picks an Explore category.

  • Cost: 1 credit
  • Cache: Results are kept up to 1 day; send max_age_days to reuse them for free.
  • Timeout: A request still running after about 25 seconds answers 202 with a job to poll (Batch and jobs).

Parameters#

NameTypeRequiredDescription
periodstringnoAccepted for compatibility; the Explore feed has no time window. One of 7, 30.
sortstringnoAccepted for compatibility; not applied. One of views, likes, comments, shares. Also accepted as sort_by, sortBy, order.
categorystringnoTikTok's numeric Explore category id (default 1).

Every request also accepts:

  • cursor: the cursor from the previous page (Pagination).
  • region: two-letter country code for results that vary by country. Changing it restarts the cursor chain.
  • trim: true for a smaller response without null fields and extra.
  • raw: true to also get the platform's original object as raw.
  • max_age_days: accept a cached result up to this many days old, for 0 credits (Caching).

Example request#

Set your key in the environment first (see Authentication).

1curl -G "https://api.socialscrape.dev/v1/tiktok/videos/popular" \2  -H "x-api-key: $SOCIALSCRAPE_API_KEY" \3  --data-urlencode "region=US"

Example response#

This is a sample from a recorded response, lists and long text are shortened. Status 200.

200 OKSample response
1{2  "ok": true,3  "credits_charged": 1,4  "credits_remaining": 4999,5  "cached": false,6  "cached_at": null,7  "request_id": "req_f64ceef95a71479395ed042a",8  "data": {9    "object": "list",10    "items": [11      {12        "object": "post",13        "platform": "tiktok",14        "id": "7694032058280119583",15        "url": "https://www.tiktok.com/@bbykitty38/video/7694032058280119583",16        "type": "video",17        "author": {18          "id": "7657915122313528334",19          "handle": "bbykitty38",20          "name": "Bbykitty",21          "url": "https://www.tiktok.com/@bbykitty38",22          "avatar_url": "https://p16-common-sign.tiktokcdn-us.com/tos-useast8-avt-0068-tx2/262858978cba062bcf89c7975ff729ac~tplv-tiktokx-cropcenter:100:100.jpeg?dr=9640&refresh_token=e02bfac9&x-expires=1793498400&x-signature=inSY%2FLBCQ3UKdRWUzMddsLhy3vc%3D&t=4d5b0...",23          "verified": false24        },25        "title": null,26        "text": "#CapCut Toc Toc 😂 |⬆️ Tap on the template anchor to recreate yours #CapCut #capcutpioneer #pioneertemplate",27        "published_at": "2026-10-07T20:54:17Z",28        "duration_seconds": 11.0,29        "language": "en",30        "hashtags": [31          "capcut",32          "capcutpioneer",33          "pioneertemplate"34        ],35        "mentions": null,36        "stats": {37          "views": 155900,38          "likes": 3758,39          "comments": 38,40          "shares": 1526,41          "saves": 345,42          "dislikes": null43        },44        "media": {45          "thumbnail_url": "https://p19-common-sign.tiktokcdn-us.com/tos-useast8-p-0068-tx2/osE3XcQAVeAFSErYuuRm2xfgBFD6EB8QjHvqDN~tplv-tiktokx-origin.image?dr=9636&x-expires=1793498400&x-signature=FdJS4sPAoeB17mL3KpUwL0nBPq0%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shc...",46          "video_url": "https://v16-webapp-prime.us.tiktok.com/video/tos/useast8/tos-useast8-ve-0068c001-tx2/oYEADEA7XwBxazBVKCQgBIaJsgGxSRbiYzisP/?a=1988&bti=ODszNWYuMDE6&&bt=2069&ft=aEeq8qT0mIoPD12cAAiI3wUhT9AbMeF~O5&mime_type=video_mp4&rc=ZjwzO2U1NTZpZGdkZDhmOE...",47          "audio_url": null,48          "image_urls": null,49          "width": 720,50          "height": 126051        },52        "song": {53          "id": "7690651570417060641",54          "title": "son original",55          "artist": "CASTING GASTRO",56          "url": "https://www.tiktok.com/music/son-original-7690651570417060641"57        },58        "location": null,59        "is_pinned": null,60        "is_sponsored": false,61        "extra": {62          "ai_label_shown": true,63          "author_followers": 161200,64          "category_type": 106,65          "comments_disabled": false,66          "duet_enabled": true,67          "is_private": false,68          "music_is_original": true,69          "reposts": 0,70          "stitch_enabled": true,71          "video_definition": "720p"72        }73      },74      {75        "object": "post",76        "platform": "tiktok",77        "id": "7697318897640377631",78        "url": "https://www.tiktok.com/@naohh_ark765/video/7697318897640377631",79        "type": "video",80        "author": {81          "id": "7697305375733744653",82          "handle": "naohh_ark765",83          "name": "naohh_ark765",84          "url": "https://www.tiktok.com/@naohh_ark765",85          "avatar_url": "https://p19-common-sign.tiktokcdn-us.com/tos-useast8-avt-0068-tx2/c9da8fd5fb244ed6b39b85a95976a185~tplv-tiktokx-cropcenter:100:100.jpeg?dr=9640&refresh_token=7dfb052e&x-expires=1793498400&x-signature=3F6rhfNUPcKKErBQMSjphsy74Po%3D&t=4d5b047...",86          "verified": false87        },88        "title": null,89        "text": "Noah's Ark - did the legendary vessel really survive the Great Flood, and where is it today??? Noah's Ark, Great Flood, Ancient Mysteries, Mount Ararat, Biblical History, Archaeological Discoveries, Unsolved Mysteries #NoahsArk #GreatFlood...",90        "published_at": "2026-10-16T17:28:54Z",91        "duration_seconds": 10.0,92        "language": "en",93        "hashtags": [94          "noahsark",95          "greatflood",96          "ancienthistory"97        ],98        "mentions": null,99        "stats": {100          "views": 24000000,101          "likes": 1800000,102          "comments": 42200,103          "shares": 91300,104          "saves": 126147,105          "dislikes": null106        },107        "media": {108          "thumbnail_url": "https://p16-common-sign.tiktokcdn-us.com/tos-useast8-p-0068-tx2/oQBSISw21Eq1CYi9XAairHeiIiBBtWAuCAPat9~tplv-tiktokx-origin.image?dr=9636&x-expires=1793498400&x-signature=ijG5vSU7TsbDq1%2F4R78A%2ByFiDJI%3D&t=4d5b0474&ps=13740610&shp=81f88b70...",109          "video_url": "https://video-ttp2-bp.us.tiktok.com/e165591be397843d1478b88c828c51f5/6ae6a142/kmoat/mps/logo/v2/r/p/v15044gf0000db95s27og65tmvcas1o0/b12fdccdc8734fc1b9a7e444d38e590c/fbe785663713918b2a1e93cd16166fd3/mp4/main.mp4?a=1988&bti=ODszNWYuMDE6&&bt=...",110          "audio_url": null,111          "image_urls": null,112          "width": 576,113          "height": 1024114        },115        "song": {116          "id": "7265056503707044614",117          "title": "الصوت الأصلي",118          "artist": "حسين مالك |🇮🇶",119          "url": "https://www.tiktok.com/music/%D8%A7%D9%84%D8%B5%D9%88%D8%AA-%D8%A7%D9%84%D8%A3%D8%B5%D9%84%D9%8A-7265056503707044614"120        },121        "location": null,122        "is_pinned": null,123        "is_sponsored": false,124        "extra": {125          "ai_label_shown": true,126          "author_followers": 118800,127          "category_type": 120,128          "comments_disabled": false,129          "duet_enabled": true,130          "is_private": false,131          "music_is_original": true,132          "reposts": 0,133          "stitch_enabled": true,134          "video_definition": "540p"135        }136      }137    ],138    "cursor": "c16",139    "has_more": true,140    "parent": null141  },142  "cursor": "c16",143  "has_more": true144}

Response#

A list of Post objects in data.items, with data.cursor and data.has_more.

See Data models for every field. The envelope around data is described in Responses.

Errors#

Failures are free: credits_charged is 0. Branch on error.code, never on the message.

CodeHTTPRetryMeaning
invalid_params400noA parameter is missing, unknown or has the wrong type.
not_found404noThe platform says this profile, post or item does not exist.

Every request can also fail with the account and platform errors listed on the Errors page.