Unofficial TikTok Story Highlights API

Get a user's highlights — all collections and the stories inside each.

Returns

username, sec_uid, total_collections, total_stories, and a collections array; each collection has collection_id, title, cover, and a stories array (raw objects, or trimmed with format=clean).

Example Request

Copyhttps://dev.omar-thing.site/api/v1/highlights?username=tiktok&format=clean&key=YOUR_API_KEY

Example Response

Copy{
  "data": {
    "collections": [
      {
        "collection_id": "7300000000000000000",
        "cover": "https://p16-sign.../cover.jpeg",
        "stories": [
          {
            "...": "many more raw fields",
            "aweme_id": "7460000000000000000",
            "create_time": 1736900000,
            "desc": "",
            "statistics": {
              "digg_count": 320,
              "play_count": 5000
            },
            "video": {
              "...": "more video fields",
              "play_addr": {
                "url_list": [
                  "https://v16-webapp.../v.mp4"
                ]
              }
            }
          },
          {
            "...": "7 more stories"
          }
        ],
        "title": "Travel",
        "total_stories": 8
      },
      {
        "...": "1 more collection"
      }
    ],
    "sec_uid": "MS4wLjABAAAA...",
    "total_collections": 2,
    "total_stories": 14,
    "username": "someuser"
  },
  "note": "Default (raw) response — each story is a full TikTok aweme object (trimmed with … here). Add ?format=clean for a small subset.",
  "status": "success"
}