Skip to content
truescrape
Free key

Contents

Site

TikTok User Videos API

Open in ChatGPTOpen in ClaudeOpen in Gemini

A creator's public posts, newest first, with view/like/comment/share counts. Photo posts are included and typed as image or carousel. Up to 15 per page, with a cursor for older posts. Calls cost 1 credit each. A cache hit is free, and a failed or empty response is never charged.

Try it

Prefilled with the request that produced the example below. No key yet? Get a free key.

Request

GET/v1/tiktok/user-videos
ParameterTypeRequiredDescription
handlestringyesHandle (@nike), or a full tiktok.com profile URL
countnumbernoItems per page (default 35, max 35)
cursorstringnopagination.cursor from a previous response
max_cursorstringnopagination.cursor from a previous response

Also accepts cache_max_age (a hit costs 0 credits) and include_raw (returns the untouched upstream payload under raw).

curl
curl "$API/v1/tiktok/user-videos?handle=nike&cache_max_age=7d" \
  -H "x-api-key: $KEY"
JavaScript
const query = new URLSearchParams({
  handle: 'nike',
  cache_max_age: '7d',
});

const response = await fetch(`${API}/v1/tiktok/user-videos?${query}`, {
  headers: { 'x-api-key': KEY },
});

const body = await response.json();
if (!body.success) throw new Error(body.error.code);

// 1 credit, 0 on a cache hit
console.log(body.data, body.meta.creditsCharged);
Python
import os, httpx

r = httpx.get(
    f"{os.environ['API']}/v1/tiktok/user-videos",
    params={
        "handle": "nike",
        "cache_max_age": "7d",
    },
    headers={"x-api-key": os.environ["KEY"]},
    timeout=30,
)

body = r.json()
if not body["success"]:
    raise RuntimeError(body["error"]["code"])

print(body["data"], body["meta"]["creditsCharged"])

Example response

Captured on , with raw removed and lists cut to two items. A live call returns current data.

response
{
  "success": true,
  "data": {
    "items": [
      {
        "platform": "tiktok",
        "id": "7698896267962862861",
        "type": "video",
        "url": "https://www.tiktok.com/@nike/video/7698896267962862861",
        "title": "After Dark Tour London: 10 out of 10K #afterdarktour #nikerunning #fyp ",
        "text": "After Dark Tour London: 10 out of 10K #afterdarktour #nikerunning #fyp ",
        "authorId": "208464585232822272",
        "authorHandle": "nike",
        "authorName": "Nike",
        "thumbnailUrl": "https://p19-common-sign.tiktokcdn-us.com/tos-useast5-p-0068-tx/oEvRUefvVAHGGRAQAIbIAxJI8OXLIEemruLfAG~tplv-tiktokx-origin.image?dr=9636&x-expires=1792717200&x-signature=3%2FpHSqqW4nPw5sNf5xQU2A99vTI%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=useast8",
        "mediaUrls": [
          "https://v16-webapp-prime.us.tiktok.com/video/tos/useast5/tos-useast5-ve-0068c003-tx/osGeCOLOAt8RxAZrUfILIJ5XgFne4XAvuAGeRS/?a=1988&bti=ODszNWYuMDE6&&bt=1362&ft=aEeq8qT0mIoPD12GPk6I3wUktBAbMeF~O5&mime_type=video_mp4&rc=Njs7N2g0PDQ8Nzk6ZWllZEBpanZoZHU5cjx5ZTMzZzczNEAvNjNiY15fNjYxX19jMmIyYSNecGJeMmRjZl9hLS1kMS9zcw%3D%3D&expire=1792720556&l=202610210155192CBB9D0BDFC9A847C3EE&ply_type=2&policy=2&signature=00138dc0c9f487aae034ee8127fb3297&tk=tt_chain_token&btag=e00088000"
        ],
        "durationSeconds": 35,
        "viewCount": 6158,
        "likeCount": 404,
        "commentCount": 15,
        "shareCount": 4,
        "hashtags": [
          "afterdarktour",
          "nikerunning"
        ],
        "mentions": [],
        "isSponsored": false,
        "publishedAt": "2026-10-20T23:30:02.000Z",
        "fetchedAt": "2026-10-21T01:55:20.468Z"
      },
      {
        "platform": "tiktok",
        "id": "7698749827965799693",
        "type": "video",
        "url": "https://www.tiktok.com/@nike/video/7698749827965799693",
        "title": "Ready? Ok! The all-new NikeSKIMS collection drops October 22nd.",
        "text": "Ready? Ok! The all-new NikeSKIMS collection drops October 22nd.",
        "authorId": "208464585232822272",
        "authorHandle": "nike",
        "authorName": "Nike",
        "thumbnailUrl": "https://p16-common-sign.tiktokcdn-us.com/tos-useast5-p-0068-tx/ocA0AfYIBBD1iA8CnXid7NEEaBJIObvw28I0oA~tplv-tiktokx-origin.image?dr=9636&x-expires=1792717200&x-signature=LuODsTL8QkBvOWFp3cagalTkWg0%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=useast8",
        "mediaUrls": [
          "https://v16-webapp-prime.us.tiktok.com/video/tos/useast5/tos-useast5-ve-0068c002-tx/oYCnA6mrpLeUpIuAgVIG1MekRFcfAgn0Hku5Aj/?a=1988&bti=ODszNWYuMDE6&&bt=2404&ft=aEeq8qT0mIoPD12GPk6I3wUktBAbMeF~O5&mime_type=video_mp4&rc=aTllNDNpODk5PGRkZTs7OUBpajw6Onc5cjpxZTMzZzczNEAzLS82Y2EuXjExNmJhMzJfYSNoLTZhMmQ0NV9hLS1kMS9zcw%3D%3D&expire=1792720537&l=202610210155192CBB9D0BDFC9A847C3EE&ply_type=2&policy=2&signature=813303aabf7b80c7f6f23497b031b5b1&tk=tt_chain_token&btag=e000b0000"
        ],
        "durationSeconds": 17,
        "viewCount": 12800,
        "likeCount": 458,
        "commentCount": 32,
        "shareCount": 13,
        "hashtags": [],
        "mentions": [],
        "isSponsored": false,
        "publishedAt": "2026-10-20T14:01:52.000Z",
        "fetchedAt": "2026-10-21T01:55:20.468Z"
      }
    ]
  },
  "pagination": {
    "cursor": "1790715177000",
    "hasMore": true,
    "count": 15
  },
  "meta": {
    "platform": "tiktok",
    "endpoint": "tiktok.userVideos",
    "creditsCharged": 1,
    "cached": false,
    "cacheAgeSeconds": null,
    "durationMs": 922,
    "requestId": "req_mhyyc6whaix2x9ssfuiq"
  }
}

Returns

Returns a list of Post in data.items.

Cost and behaviour

Credits1 per live request, 0 on a cache hit
Cacheableyes: cache_max_age accepts a cached copy
Batchableyes: usable as a target in POST /v1/jobs/batch
Subscribableyes: as often as every 3600 seconds, firing a webhook only on a change

Other TikTok endpoints

All TikTok endpointsThe unified schema