TikTok Collection API Documentation

GET   /api/v1/search?engine=tiktok_collection

The TikTok Collection API returns the videos saved in a public TikTok collection, a folder of videos a creator shares from their profile, together with the collection's name, cover, video count and owner. Each video carries its author, caption, publish time, engagement counts and sound. Page through the whole collection with pagination.next_page_token.

API Parameters

Collection

  • Name
    collection_id
    Required
    Optional
    Description

    The numeric ID of a public TikTok collection (e.g. 7394627756635573022), the trailing number of its page link. Returns the collection's name, cover, video count and owner, and its videos in the order the collection lists them. Required unless url or next_page_token is set.

  • Name
    url
    Required
    Optional
    Description

    The collection's page link, used instead of collection_id (e.g. https://www.tiktok.com/@tiktok/collection/Summer-of-Sports-7394627756635573022). Pass either url or collection_id, not both.

Pagination

  • Name
    next_page_token
    Required
    Optional
    Description

    Token for the next page of up to 15 videos, returned as pagination.next_page_token while pagination.has_more is true. The token carries the collection, so collection_id and url can be left out. A page can hold fewer than 15 videos when TikTok withholds some of them, so page until pagination is no longer returned.

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_collection.

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

The collection block names the collection and its owner, and videos_count is the number of videos TikTok counts in it. Each video is numbered by its position on the page.

GET
https://www.searchapi.io/api/v1/search?collection_id=7394627756635573022&engine=tiktok_collection
Request
import requests

url = "https://www.searchapi.io/api/v1/search"
params = {
  "engine": "tiktok_collection",
  "collection_id": "7394627756635573022"
}

response = requests.get(url, params=params)
print(response.text)
Response
{
  "search_metadata": {
    "id": "search_bsbS1Cph8XdGSBCl61GOfMTw",
    "status": "Success",
    "created_at": "2026-10-01T02:39:38Z",
    "request_time_taken": 2.14,
    "parsing_time_taken": 0.02,
    "total_time_taken": 2.16,
    "request_url": "https://www.tiktok.com/@tiktok/collection/Summer-of-Sports-7394627756635573022",
    "html_url": "https://www.searchapi.io/api/v1/searches/search_bsbS1Cph8XdGSBCl61GOfMTw.html",
    "json_url": "https://www.searchapi.io/api/v1/searches/search_bsbS1Cph8XdGSBCl61GOfMTw"
  },
  "search_parameters": {
    "engine": "tiktok_collection",
    "collection_id": "7394627756635573022"
  },
  "collection": {
    "id": "7394627756635573022",
    "name": "Summer of Sports",
    "link": "https://www.tiktok.com/@tiktok/collection/Summer-of-Sports-7394627756635573022",
    "cover": "https://p16-common-sign.tiktokcdn-us.com/tos-useast5-p-0068-tx/oYQIDWNuYCYeHwMTg8ffGkBAQLFT0YdJD7qAj...",
    "videos_count": 139,
    "owner": {
      "id": "107955",
      "username": "tiktok",
      "link": "https://www.tiktok.com/@tiktok"
    }
  },
  "videos": [
    {
      "position": 1,
      "id": "7399631056783035690",
      "link": "https://www.tiktok.com/@nojo18/video/7399631056783035690",
      "type": "video",
      "language": "un",
      "iso_date": "2024-08-05T12:27:54Z",
      "duration": 48,
      "width": 768,
      "height": 576,
      "is_duet_enabled": true,
      "is_stitch_enabled": true,
      "views": 3300000,
      "likes": 500800,
      "comments": 3099,
      "shares": 22600,
      "saves": 39009,
      "thumbnail": "https://p19-common-sign.tiktokcdn-us.com/tos-useast5-p-0068-tx/oYQIDWNuYCYeHwMTg8ffGkBAQLFT0YdJD7qAj...",
      "dynamic_thumbnail": "https://p19-common-sign.tiktokcdn-us.com/tos-useast5-p-0068-tx/b10f3518bf2f42519e0b7e1e4069050f_1722...",
      "video_meta": {
        "definition": "540p",
        "ratio": "540p",
        "format": "mp4",
        "codec_type": "h264",
        "size": 7171166,
        "bitrate": 1179662,
        "bitrates": [
          {
            "gear_name": "normal_540_0",
            "bitrate": 1179662,
            "fps": 23,
            "codec_type": "h264",
            "format": "mp4"
          },
          "..."
        ]
      },
      "music": {
        "id": "7399631020024285998",
        "title": "original sound",
        "author": "Noah Lyles",
        "cover": "https://p19-common-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/16b25128fbffca038bc04db11c0fd800~tp...",
        "duration": 48,
        "play_url": "https://v16m.tiktokcdn-us.com/cbd33aa21bbeca1d4b91b1f3553ee902/6abe1c7b/video/tos/useast5/tos-useast...",
        "is_original": true,
        "is_copyrighted": true,
        "link": "https://www.tiktok.com/music/original-sound-7399631020024285998"
      },
      "subtitles": [
        {
          "language": "eng-US",
          "format": "webvtt",
          "source": "ASR",
          "url": "https://v16m-webapp.tiktokcdn-us.com/ae485a5f6a456b955d53747503200a02/6ac06b1b/video/tos/useast5/tos...",
          "url_expires_at": "2026-10-03T02:40:27Z"
        },
        "..."
      ],
      "author": {
        "id": "6791598551904076805",
        "sec_uid": "MS4wLjABAAAAH10iXqncdQ9WqgUozawE5UFvRGS_WuS7bqXNwCmYyURFVweqtROjIPuZOB6ctng1",
        "username": "nojo18",
        "link": "https://www.tiktok.com/@nojo18",
        "name": "Noah Lyles",
        "bio": "Official TikTok of Noah Lyles \nOlympian, World Champion, Adidas athletes",
        "avatar": "https://p19-common-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/16b25128fbffca038bc04db11c0fd800~tp...",
        "avatar_hd": "https://p19-common-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/16b25128fbffca038bc04db11c0fd800~tp...",
        "is_verified": true,
        "followers": 442600,
        "following": 274,
        "hearts": 4500000,
        "posts": 63
      }
    },
    "..."
  ],
  "pagination": {
    "has_more": true,
    "next_page_token": "eyJjdXJzb3IiOiIxNSIsImNvbGxlY3Rpb25faWQiOiI3Mzk0NjI3NzU2NjM1NTczMDIyIn0="
  }
}

Next Page using next_page_token parameter

Pass the previous page's pagination.next_page_token on its own to get the next page. The last page returns no pagination block.

GET
https://www.searchapi.io/api/v1/search?engine=tiktok_collection&next_page_token=eyJjdXJzb3IiOiIxNSIsImNvbGxlY3Rpb25faWQiOiI3Mzk0NjI3NzU2NjM1NTczMDIyIn0%3D
Request
import requests

url = "https://www.searchapi.io/api/v1/search"
params = {
  "engine": "tiktok_collection",
  "next_page_token": "eyJjdXJzb3IiOiIxNSIsImNvbGxlY3Rpb25faWQiOiI3Mzk0NjI3NzU2NjM1NTczMDIyIn0="
}

response = requests.get(url, params=params)
print(response.text)
Response
{
  "search_metadata": {
    "id": "search_X6qTcioOP5J6MB3cPUT41qLd",
    "status": "Success",
    "created_at": "2026-10-01T02:39:40Z",
    "request_time_taken": 2.92,
    "parsing_time_taken": 0.01,
    "total_time_taken": 2.93,
    "request_url": "https://www.tiktok.com/@tiktok/collection/Summer-of-Sports-7394627756635573022",
    "html_url": "https://www.searchapi.io/api/v1/searches/search_X6qTcioOP5J6MB3cPUT41qLd.html",
    "json_url": "https://www.searchapi.io/api/v1/searches/search_X6qTcioOP5J6MB3cPUT41qLd"
  },
  "search_parameters": {
    "engine": "tiktok_collection",
    "collection_id": "7394627756635573022",
    "next_page_token": "eyJjdXJzb3IiOiIxNSIsImNvbGxlY3Rpb25faWQiOiI3Mzk0NjI3NzU2NjM1NTczMDIyIn0="
  },
  "videos": [
    {
      "position": 1,
      "id": "7398123541402570015",
      "link": "https://www.tiktok.com/@itsgabbythomas/video/7398123541402570015",
      "type": "video",
      "caption": "What we’ve all been waiting for 😃 @Alexis Holmes @ #fyp #olympics #paris2024 #track #running #usa ",
      "language": "en",
      "hashtags": [
        "fyp",
        "olympics",
        "paris2024",
        "track",
        "running",
        "usa"
      ],
      "mentions": [
        "trackqueenlex"
      ],
      "iso_date": "2024-08-01T10:58:34Z",
      "duration": 5,
      "width": 576,
      "height": 1024,
      "is_duet_enabled": true,
      "is_stitch_enabled": true,
      "views": 877000,
      "likes": 86400,
      "comments": 371,
      "shares": 812,
      "saves": 1750,
      "thumbnail": "https://p19-common-sign.tiktokcdn-us.com/tos-useast8-p-0068-tx2/197e374b3ea741ed9d71b919cbdcf872_172...",
      "dynamic_thumbnail": "https://p19-common-sign.tiktokcdn-us.com/tos-useast8-p-0068-tx2/2ec6eae1f72b4563ae715732f375fef7_172...",
      "video_meta": {
        "definition": "540p",
        "ratio": "540p",
        "format": "mp4",
        "codec_type": "h264",
        "size": 1494162,
        "bitrate": 2308923,
        "bitrates": [
          {
            "gear_name": "normal_540_0",
            "bitrate": 2308923,
            "fps": 30,
            "codec_type": "h264",
            "format": "mp4"
          },
          "..."
        ]
      },
      "music": {
        "id": "7237212440625253163",
        "title": "original sound",
        "author": "kardashianshulu",
        "cover": "https://p16-common-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/b050d65942d0f6316e870607d5378cc4~tp...",
        "duration": 30,
        "play_url": "https://v16m.tiktokcdn-us.com/59b13eb6f23a22ea46c91c889263ba3c/6abe1c6c/video/tos/useast5/tos-useast...",
        "is_original": true,
        "link": "https://www.tiktok.com/music/original-sound-7237212440625253163"
      },
      "subtitles": [
        {
          "language": "eng-US",
          "format": "webvtt",
          "source": "ASR",
          "url": "https://v16m-webapp.tiktokcdn-us.com/9556102cba637debf61de970c7bab9dd/6ac06af3/video/tos/useast8/tos...",
          "url_expires_at": "2026-10-03T02:39:47Z"
        },
        "..."
      ],
      "author": {
        "id": "6728812859868693509",
        "sec_uid": "MS4wLjABAAAAS4hBNOW02ZXlm98_JtheBmO5lVpWZoY4t9Nqz3ToPZb0A948HmOMHOg34L8U66XQ",
        "username": "itsgabbythomas",
        "link": "https://www.tiktok.com/@itsgabbythomas",
        "name": "Gabby Thomas",
        "bio": "🏃🏾‍♀️ 🤓",
        "avatar": "https://p16-common-sign.tiktokcdn-us.com/tos-useast8-avt-0068-tx2/1cf585f28f97c4d32aab2577c73e0ad6~t...",
        "avatar_hd": "https://p19-common-sign.tiktokcdn-us.com/tos-useast8-avt-0068-tx2/1cf585f28f97c4d32aab2577c73e0ad6~t...",
        "is_verified": true,
        "followers": 358200,
        "following": 343,
        "hearts": 11600000,
        "posts": 579
      }
    },
    "..."
  ],
  "pagination": {
    "has_more": true,
    "next_page_token": "eyJjdXJzb3IiOiIzMCIsImNvbGxlY3Rpb25faWQiOiI3Mzk0NjI3NzU2NjM1NTczMDIyIn0="
  }
}