Logo SearchApi

TikTok Profile Videos API Documentation

GET   /api/v1/search?engine=tiktok_profile_videos
OpenAPI Initiative Download OpenAPI Spec

The TikTok Profile Videos API returns a profile's video feed. You can paginate through the full feed with pagination.next_page_token.

API Parameters

Search Query

  • Name
    username
    Required
    Required
    Description

    Parameter defines the TikTok username you want to retrieve videos for. You can use the username with or without the @ symbol.
    For example, @therock and therock will both retrieve the same creator's feed.

Filters

  • Name
    sort_by
    Required
    Optional
    Description

    Parameter defines the order of the returned videos. It can be set to latest (default), popular, or oldest.

Pagination

  • Name
    next_page_token
    Required
    Optional
    Description

    Parameter defines the token used to retrieve the next page of videos. It is returned as pagination.next_page_token when more videos are available.

Engine

  • Name
    engine
    Required
    Required
    Description

    Parameter defines an engine that will be used to retrieve real-time data. It must be set to tiktok_profile_videos.

API key

  • Name
    api_key
    Required
    Required
    Description

    The api_key authenticates your requests. Use it as a query parameter (https://www.searchapi.io/api/v1/search?api_key=YOUR_API_KEY) or in the Authorization header (Bearer YOUR_API_KEY).

Zero Data Retention

  • Name
    zero_retention
    Enterprise Only
    Enterprise Only
    Required
    Optional
    Description

    Set this parameter to true to disable all logging and persistent storage. No request parameters, HTML, or JSON responses are stored or logged. Suitable for high-compliance use cases. Debugging and support may be limited while enabled.

API Examples

Full Response

Full Response
GET
https://www.searchapi.io/api/v1/search?engine=tiktok_profile_videos&username=khaby.lame
Request
import requests

url = "https://www.searchapi.io/api/v1/search"
params = {
  "engine": "tiktok_profile_videos",
  "username": "khaby.lame"
}

response = requests.get(url, params=params)
print(response.text)
Response
{
  "search_metadata": {
    "id": "search_9KqL3mNpVdRtY6wZ2hBfXs",
    "status": "Success",
    "created_at": "2026-06-30T18:12:07Z",
    "request_time_taken": 4.83,
    "parsing_time_taken": 0.02,
    "total_time_taken": 4.85,
    "request_url": "https://www.tiktok.com/@khaby.lame",
    "html_url": "https://www.searchapi.io/api/v1/searches/search_9KqL3mNpVdRtY6wZ2hBfXs.html",
    "json_url": "https://www.searchapi.io/api/v1/searches/search_9KqL3mNpVdRtY6wZ2hBfXs"
  },
  "search_parameters": {
    "engine": "tiktok_profile_videos",
    "username": "khaby.lame"
  },
  "profile": {
    "id": "127905465618821121",
    "username": "khaby.lame",
    "link": "https://www.tiktok.com/@khaby.lame",
    "name": "Khabane lame",
    "bio": "Se vuoi ridere sei nel posto giusto😎 If u wanna laugh u r in the right place😎",
    "avatar": "https://p16-common-sign.tiktokcdn.com/tos-maliva-avt-0068/08987e23b94057953fd4f1738694bf5f~tplv-tiktokx-cropcenter:720:720.jpeg?dr=14579&refresh_token=429e9ccf&x-expires=1783040400&x-signature=9Izkc0MgWKzgXof6iR%2BpsvodryA%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my2",
    "is_verified": true,
    "followers": 162300000,
    "following": 80,
    "hearts": 2600000000,
    "posts": 1335
  },
  "videos": [
    {
      "position": 1,
      "id": "7657202490991054110",
      "caption": "We never ever gonna play again 🤕@jbastys #learnfromkhaby #comedy ",
      "link": "https://www.tiktok.com/@khaby.lame/video/7657202490991054110",
      "iso_date": "2026-06-30T14:56:38Z",
      "duration": 18,
      "width": 720,
      "height": 1280,
      "views": 707400,
      "likes": 95800,
      "comments": 2461,
      "shares": 2798,
      "saves": 4235,
      "thumbnail": "https://p16-common-sign.tiktokcdn.com/tos-useast8-p-0068-tx2/oEfqGfRdEODQNDAEp2FkYIaSEhhOIABm9NDVuA~tplv-tiktokx-origin.image?dr=14575&x-expires=1783040400&x-signature=GoYSbquZgyPm2giOHcCzoUE078E%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my2",
      "dynamic_thumbnail": "https://p19-common-sign.tiktokcdn-us.com/tos-useast8-p-0068-tx2/osVYkmBhIENNqATE92qEDDSBQIjOVfHfAAuFxR~tplv-tiktokx-origin.image?dr=9636&x-expires=1783526400&x-signature=wA%2Bz6CfB59r0IEOvDjKETZduqFo%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=useast8",
      "music": {
        "id": "7657202437576608542",
        "title": "original sound",
        "author": "Khabane lame",
        "cover": "https://p19-common-sign.tiktokcdn-us.com/tos-useast8-avt-0068-tx2/08987e23b94057953fd4f1738694bf5f~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=9640&refresh_token=80c2c36b&x-expires=1783526400&x-signature=N7FtfdXuaVdBdxp6UHeyKAA9QbE%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=useast8",
        "duration": 18,
        "is_original": true,
        "link": "https://www.tiktok.com/music/original-sound-7657202437576608542"
      },
      "hashtags": [
        "learnfromkhaby",
        ...
      ],
      "mentions": [
        "jbastys",
        ...
      ]
    },
    ...
  ],
  "pagination": {
    "has_more": true,
    "next_page_token": "eyJjdXJzb3IiOiIxNzc3Mzk5MDU1MDAwIiwidXNlcm5hbWUiOiJraGFieS5sYW1lIn0="
  }
}

Popular Videos using sort_by parameter

Popular Videos using <code>sort_by</code> parameter
GET
https://www.searchapi.io/api/v1/search?engine=tiktok_profile_videos&sort_by=popular&username=mrbeast
Request
import requests

url = "https://www.searchapi.io/api/v1/search"
params = {
  "engine": "tiktok_profile_videos",
  "username": "mrbeast",
  "sort_by": "popular"
}

response = requests.get(url, params=params)
print(response.text)
Response
{
  "search_metadata": {
    "id": "search_875nmM02pVWXiGDMgwE4z1Yx",
    "status": "Success",
    "created_at": "2026-07-09T18:58:15Z",
    "request_time_taken": 5.27,
    "parsing_time_taken": 0.04,
    "total_time_taken": 5.31,
    "request_url": "https://www.tiktok.com/@mrbeast",
    "html_url": "https://www.searchapi.io/api/v1/searches/search_875nmM02pVWXiGDMgwE4z1Yx.html",
    "json_url": "https://www.searchapi.io/api/v1/searches/search_875nmM02pVWXiGDMgwE4z1Yx"
  },
  "search_parameters": {
    "engine": "tiktok_profile_videos",
    "username": "mrbeast",
    "sort_by": "popular"
  },
  "profile": {
    "id": "6614519312189947909",
    "username": "mrbeast",
    "link": "https://www.tiktok.com/@mrbeast",
    "name": "MrBeast",
    "bio": "Watch my latest video! 👇",
    "avatar": "https://p16-common-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/1e2348ca19d394037718e3b1d3fc2958~tplv-tiktokx-cropcenter:720:720.jpeg?dr=9640&refresh_token=837db3b6&x-expires=1783792800&x-signature=HEh%2FVmumzNOMYndaNYq3G3r6Xvo%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=useast8",
    "is_verified": true,
    "followers": 129100000,
    "following": 353,
    "hearts": 1300000000,
    "posts": 461
  },
  "videos": [
    {
      "position": 1,
      "id": "7505849400019717406",
      "link": "https://www.tiktok.com/@mrbeast/video/7505849400019717406",
      "caption": "You can call me MrLean now 🥶",
      "language": "en",
      "iso_date": "2025-05-18T18:09:25Z",
      "duration": 14,
      "width": 576,
      "height": 1024,
      "is_duet_enabled": true,
      "is_stitch_enabled": true,
      "views": 323200000,
      "likes": 28800000,
      "comments": 358400,
      "shares": 3000000,
      "saves": 2518394,
      "thumbnail": "https://p16-common-sign.tiktokcdn-us.com/tos-useast8-p-0068-tx2/owVfKJSRCEbwEIEEEoiAkJD8FUfAAClAAIlqAy~tplv-tiktokx-origin.image?dr=9636&x-expires=1783792800&x-signature=%2FwA3I040eDFxo8zp4Ej3bxfHwhM%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=useast8",
      "dynamic_thumbnail": "https://p19-common-sign.tiktokcdn-us.com/tos-useast8-p-0068-tx2/owVfKJSRCEbwEIEEEoiAkJD8FUfAAClAAIlqAy~tplv-tiktokx-origin.image?dr=9636&x-expires=1783792800&x-signature=Ax8mXF6sjuygsaXrgrOREQvEdY4%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=useast8",
      "video_meta": {
        "definition": "540p",
        "ratio": "540p",
        "format": "mp4",
        "codec_type": "h264",
        "size": 996030,
        "bitrate": 541320,
        "bitrates": [
          {
            "gear_name": "adapt_lowest_1080_1",
            "bitrate": 574902,
            "fps": 30,
            "codec_type": "h265_hvc1",
            "format": "mp4"
          },
          ...
        ]
      },
      "music": {
        "id": "7505849380663020319",
        "title": "original sound",
        "author": "MrBeast",
        "cover": "https://p19-common-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/1e2348ca19d394037718e3b1d3fc2958~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=9640&refresh_token=08979e83&x-expires=1783792800&x-signature=SlJ85zR2dIusrW8Jx1kv0HLT6%2FQ%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=useast8",
        "duration": 14,
        "play_url": "https://v19.tiktokcdn-us.com/87826440f8ab0e337b401a7e63e787d9/6a5043ba/video/tos/useast8/tos-useast8-v-27dcd7-tx2/ocgUxCAVeEIBfSBlAGTQvLC0RIIqLoARcEAITe/?a=1233&bti=ODszNWYuMDE6&&bt=125&ft=GSDrKInz7ThcadSGXq8Zmo&mime_type=audio_mpeg&rc=MzQzOHk5cnA1MzMzaTU8NEBpMzQzOHk5cnA1MzMzaTU8NEBhZXI0MmQ0MWlhLS1kMTJzYSNhZXI0MmQ0MWlhLS1kMTJzcw%3D%3D&vvpl=1&l=202607091858197DD46242C9B5EB182C9C&btag=e00078000",
        "is_original": true,
        "link": "https://www.tiktok.com/music/original-sound-7505849380663020319"
      },
      "subtitles": [
        {
          "language": "eng-US",
          "format": "webvtt",
          "source": "ASR",
          "url": "https://v16m-webapp.tiktokcdn-us.com/27851a91bd6b7caecb35ed3379f70008/6a52925a/video/tos/useast8/tos-useast8-v-0068-tx2/13125d328f7845628b1d1bae11427069/?a=1988&bti=ODszNWYuMDE6&&bt=11678&ft=4KLMeMzm8Zmo0E6ira4jV4fjQpWrKsd.&mime_type=video_mp4&rc=M2Q7PHY5cmc1MzMzaTczNEBpM2Q7PHY5cmc1MzMzaTczNEBpX21xMmRrL2lhLS1kMTJzYSNpX21xMmRrL2lhLS1kMTJzcw%3D%3D&l=202607091858197DD46242C9B5EB182C9C&btag=e00078000"
        },
        ...
      ]
    },
    ...
  ],
  "pagination": {
    "has_more": true,
    "next_page_token": "eyJjdXJzb3IiOiIxMjczNzQ0NiIsInVzZXJuYW1lIjoibXJiZWFzdCIsInNvcnRfYnkiOiJwb3B1bGFyIn0="
  }
}