Douyin Fetch User Fans List
Retrieve a Douyin user's followers list in pages. Inputs: - sec_user_id: The target user's identifier. Supply the intended user's value rather than relying on the example default. - max_time: Pagination timestamp as a string; default "0". Use the value returned by the previous response for later requests. - count: Requested number of followers; default 20, which is recommended to keep unchanged. - source_type: Request source type; default 1, but the first request must explicitly use 2. Request sequence: 1. Initialize with max_time="0" and source_type=2. This returns an empty followers list together with max_time. 2. Use the returned max_time and source_type=1 to retrieve followers. 3. For further pages, use the latest returned max_time and keep source_type=1. The result contains the followers list and pagination information. The initial empty list does not mean the user has no followers. Not following the initialization and pagination sequence may cause duplicate entries. The detailed fields for each follower are not specified in the available response schema.
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.
The initialization request and each subsequent pagination request are billed as separate calls. Initialization returns an empty follower list and still incurs the fixed per-call charge; this empty list does not mean the target user has no followers.
Parameters
Optional parameters use the platform defaults when omitted.
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
count | integer | No | 数量/Number | 20 |
max_time | string | No | 最大时间戳/Maximum timestamp | 0 |
sec_user_id | string | No | 用户sec_user_id/User sec_user_id | MS4wLjABAAAA9y04iBlVdeMQqTJbqsQZKb-tqWqWW29jPVJqideHT70 |
source_type | integer | No | 来源类型/Source type | 1 |
Invocation example
Parameter templateGenerated from the parameter configuration. Replace the sample values before use.
/agent-api/v1/tool/executeX-Api-Keycurl --request POST \
--url 'https://agentearth.ai/agent-api/v1/tool/execute?tool_name=ae_douyin_fetch_user_fans_list' \
--header "X-Api-Key: $AGENTEARTH_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"params": {}
}'No response example available yet.

