# TikTok user homepage video data

Takes sec user id, unique id, max cursor and more, all optional. Served by TikHub.

Purpose:
- Get user homepage video data
Parameters:
- sec_user_id: User sec_user_id, use sec_user_id to get user video data first, if sec_user_id is empty, use unique_id to get user video data.
- max_cursor: Maximum cursor, used for paging, the first page is 0, the second page is the max_cursor value in the first response.
- count: Maximum count number
- sort_type: Sort type, 0-Latest, 1-Hot
- unique_id: User unique_id, optional parameter, if sec_user_id is empty, use unique_id to get user video data, unique_id is also the user's username.
- About the parameters of user ID, the priority is sec_user_id > unique_id, the higher the priority, the faster the speed, and it is recommended to use only sec_user_id to get user data.
- region: Region, optional parameter, if not passed, the US region data will be used by default. After passing, the data of the corresponding country and region will be preferred, for example: US, GB, FR, JP, SG, VN, etc.
Return:
- User video data

- Tool ID: `tikhub/tiktok-app-v3-fetch-user-post-videos`
- Variant: API v1
- Name in the catalog: Tiktok, Get user homepage video data V1
- Provider: [TikHub](/providers/tikhub.md)
- Capability: [TikTok videos](/tools/tiktok/videos.md)
- Price: $0.001 per call
- Authentication: an authorised Agentik workspace is required for execution, including zero-price tools.

## Pricing contract

The provider’s price, with no markup. Billed for measured usage.


```json
{
  "model": "per_call",
  "amountUsd": 0.001
}
```

Pricing source: [https://api.tikhub.io/api/v1/tikhub/user/get_all_endpoints_info](https://api.tikhub.io/api/v1/tikhub/user/get_all_endpoints_info). Official per-success route price USD 0.001; daily upstream discounts may reduce provider cost. No discount invented for the customer. 10/second.

Price verification date: 2026-10-05.

## Complete input schema


```json
{
  "type": "object",
  "properties": {
    "sec_user_id": {
      "type": "string",
      "description": "用户sec_user_id/User sec_user_id",
      "default": "",
      "title": "Sec User Id"
    },
    "unique_id": {
      "type": "string",
      "description": "用户unique_id/User unique_id",
      "default": "",
      "title": "Unique Id"
    },
    "max_cursor": {
      "type": "integer",
      "description": "最大游标/Maximum cursor",
      "default": 0,
      "title": "Max Cursor"
    },
    "count": {
      "type": "integer",
      "description": "每页数量/Number per page",
      "default": 20,
      "title": "Count"
    },
    "sort_type": {
      "type": "integer",
      "description": "排序类型/Sort type",
      "default": 0,
      "title": "Sort Type"
    },
    "region": {
      "type": "string",
      "description": "国家地区/Region, 可选参数，如果不传则默认使用美国地区数据，传递后会优先获取对应国家地区的数据，例如：US、GB、FR等",
      "default": "",
      "title": "Region"
    }
  },
  "additionalProperties": false
}
```

## Published example

This is the provider tool’s published example. Replace example values with the user’s requested inputs, respecting the schema; do not execute an example merely to test a connection.


```json
{
  "tool_id": "tikhub/tiktok-app-v3-fetch-user-post-videos",
  "input": {
    "sec_user_id": "MS4wLjABAAAAv7iSuuXDJGDvJkmH_vz1qkDZYo1apxgzaxdBSeIuPiM",
    "unique_id": "",
    "max_cursor": 0,
    "count": 20,
    "sort_type": 0,
    "region": "US"
  }
}
```

## Execute and retrieve

Inspect again before execution, explain the price and obtain the required authority. Use MCP run_tool or POST /v1/run with this tool ID, valid input and an idempotency key. Save the returned run ID and follow the actual state. If Agentik answers that the tool is temporarily unavailable, do not retry it blindly; use discovery to propose an alternative.

A partial or uncertain result can still have consumed provider resources. Consult [billing](/docs/billing.md), [idempotency](/docs/idempotency.md) and [asynchronous results](/docs/async.md).

[Provider documentation](https://api.tikhub.io/#/TikTok-App-V3-API/fetch_user_post_videos_api_v1_tiktok_app_v3_fetch_user_post_videos_get)

[REST inspection](https://api.agentik.cc/v1/tools/tikhub/tiktok-app-v3-fetch-user-post-videos) · [OpenAPI](/openapi.json) · [Connection guide](/connect.md)

---

[HTML page](/providers/tikhub/tiktok-app-v3-fetch-user-post-videos) · [Agent index](/llms.txt)