TikTok Get User Posts
Retrieve videos posted on a user’s profile. Provide either `sec_user_id` (preferred) or `unique_id`; use `unique_id` when a `sec_user_id` is unavailable. `max_cursor` starts at 0 for the first page; for later pages, pass the cursor from the previous response when available. `count` sets the page size and defaults to 20. `sort_type` is 0 for latest or 1 for popular. `region` is optional and defaults to US. The response contains the user’s video data in `data`, together with response metadata.
Pricing
| Condition | Charge |
|---|---|
| Each call | 2.07 credits/call |
2.07 credits/call Charges are per query. A successful query is billed even if it returns no results.
Parameters
Optional parameters use the platform defaults when omitted.
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
count | integer | No | 每页数量/Number per page | 20 |
region | string | No | 国家地区/Region, 可选参数,如果不传则默认使用美国地区数据,传递后会优先获取对应国家地区的数据,例如:US、GB、FR等 | "" |
sort_type | integer | No | 排序类型/Sort type | 0 |
unique_id | string | No | 用户unique_id/User unique_id | "" |
max_cursor | integer | No | 最大游标/Maximum cursor | 0 |
sec_user_id | string | No | 用户sec_user_id/User sec_user_id | "" |
Invocation example
Copy the request and explore its response example.
/agent-api/v1/tool/executeX-Api-Keycurl --request POST \
--url 'https://agentearth.ai/agent-api/v1/tool/execute?tool_name=ae_tiktok_get_user_posts' \
--header "X-Api-Key: $AGENTEARTH_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"params": {
"count": 20,
"max_cursor": 0,
"region": "MX",
"sort_type": 0,
"unique_id": "meditacionparadormir.com"
}
}'{
"code": 200,
"data": {
"aweme_list": [
{
"author": {
"avatar_larger": {
"data_size": 0,
"height": 720,
"uri": "tos-maliva-avt-0068/99a0f36d7e2813972325b2d9e45c18f5",
"url_list": [],
"width": 720
},
"avatar_medium": {
"data_size": 0,
"height": 720,
"uri": "tos-maliva-avt-0068/99a0f36d7e2813972325b2d9e45c18f5",
"url_list": [],
"width": 720
},
"avatar_thumb": {
"data_size": 0,
"height": 720,
"uri": "tos-maliva-avt-0068/99a0f36d7e2813972325b2d9e45c18f5",
"url_list": [],
"width": 720
},
"aweme_count": 172,
"favoriting_count": 941,
"follow_status": 0
},
"aweme_id": "7337291983565622560",
"create_time": 1708346423,
"desc": "#meditacion #podcastparadormir #meditacionparadormir"
}
],
"has_more": 1,
"max_cursor": 1649583549000,
"min_cursor": 1708346423000,
"status_code": 0
},
"docs": "https://api.tikhub.io/#/TikTok-App-V3-API/fetch_user_post_videos_api_v1_tiktok_app_v3_fetch_user_post_videos_get",
"message": "Request successful. This request will incur a charge.",
"message_zh": "请求成功,本次请求将被计费。",
"request_id": "e7a47fe2-4e38-4d23-9854-6e6be8766829"
}This example shows part of the response. Copied content is valid JSON.

