TikTok user's recent videos by secUid

TikHub

Recent videos posted by a TikTok user (keyed by secUid, not username)

Capability: TikTok content research
Current price: $0.0025/call
Availability: Ready to run

What this API does

Recent videos posted by a TikTok user (keyed by secUid, not username) Retrieve one bounded result or page. Pagination is explicit; each follow-up page is another call. The catalog price is the maximum per request. Quotes use the selected limits; settlement is verified supplier cost plus 40%, with a $0.0025 minimum per successful call, including supplier waivers and successful no-match results. Read public social data without a connected social account. Results include reviewed business data and available pagination. The worked example shows selected fields from a recorded response, with at most one selected item from each list.

Agents select this operation with tool ID tikhub.tiktok-user-videos, then check its current inputs and price before a run.

Inputs and outputs

Input

countinteger · optional

items per page (default 20)

minimum: 1 · maximum: 20

coverFormatinteger · optional

cover image format (default 2)

minimum: 0 · maximum: 1000000

cursorinteger · optional

page cursor

minimum: 0 · maximum: 1000000

post_item_list_request_typeinteger · optional

sort type (default 0)

minimum: 0 · maximum: 1000000

secUidstring · required

user secUid — obtain it from tiktok.user.profile first; this endpoint does NOT accept a username

minLength: 1 · maxLength: 500

Output

dataobject

Returned data value.

Example request and output

Inspect returns this reviewed example, its estimated cost and the current input schema. Run calculates the estimate for your actual input.

Request

{
  "tool_id": "tikhub.tiktok-user-videos",
  "input": {
    "count": 5,
    "secUid": "MS4wLjABAAAAv7iSuuXDJGDvJkmH_vz1qkDZYo1apxgzaxdBSeIuPiM"
  }
}

Output

{
  "data": {
    "itemList": [
      {
        "id": "7683195368279985438",
        "desc": "hear how @Palina La Diva 🌐 spinning tracks on LIVE brings techno lovers together 🪩",
        "music": {
          "id": "7683266637168610079",
          "title": "original sound",
          "authorName": "TikTok"
        },
        "stats": {
          "diggCount": 3470,
          "shareCount": 285,
          "commentCount": 1197
        },
        "video": {
          "id": "7683195368279985438"
        },
        "author": {
          "id": "107955",
          "secUid": "MS4wLjABAAAAv7iSuuXDJGDvJkmH_vz1qkDZYo1apxgzaxdBSeIuPiM",
          "nickname": "TikTok",
          "uniqueId": "tiktok"
        },
        "statsV2": {
          "diggCount": "3470",
          "shareCount": "285",
          "commentCount": "1197"
        },
        "contents": [
          {
            "desc": "hear how @Palina La Diva 🌐 spinning tracks on LIVE brings techno lovers together 🪩",
            "textExtra": [
              {
                "secUid": "MS4wLjABAAAAfCHQJzucD3eL9ppy23Bzi07hMMnkxk1nb21II7HATKSfFniTw3rZyMjQ5qGHJeZj"
              }
            ]
          }
        ],
        "textExtra": [
          {
            "secUid": "MS4wLjABAAAAfCHQJzucD3eL9ppy23Bzi07hMMnkxk1nb21II7HATKSfFniTw3rZyMjQ5qGHJeZj"
          }
        ],
        "authorStats": {
          "diggCount": 4307,
          "heartCount": 463600000,
          "videoCount": 1503,
          "followerCount": 95700000,
          "followingCount": 1
        },
        "authorStatsV2": {
          "diggCount": "4307",
          "heartCount": "463600000",
          "videoCount": "1503",
          "followerCount": "95700000",
          "followingCount": "1"
        }
      }
    ]
  }
}

Errors and limitations

invalid_input: The lookup fields or limits are invalid.example: {"secUid":"MS4wLjABAAAAv7iSuuXDJGDvJkmH_vz1qkDZYo1apxgzaxdBSeIuPiM","count":5}
upstream_error: The provider could not complete a verified result; the wallet was not charged.Check the documented fields and contact Scrollport support with the run ID if needed.

Use TikTok user's recent videos by secUid with Scrollport

Get started

Use verified tools with pay-per-use pricing. Provider access is included. Tools that work in your own apps ask you to connect that account.

Connect your first agent to receive $1 trial credit.