Douyin Fetch User Fans List

2.07 credits/call
ae_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.

Social
2.07 credits/call

Pricing

2.07 credits/call
ConditionCharge
Each call2.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.

ParameterTypeRequiredDescriptionDefault
countintegerNo数量/Number20
max_timestringNo最大时间戳/Maximum timestamp0
sec_user_idstringNo用户sec_user_id/User sec_user_idMS4wLjABAAAA9y04iBlVdeMQqTJbqsQZKb-tqWqWW29jPVJqideHT70
source_typeintegerNo来源类型/Source type1

Invocation example

Parameter template

Generated from the parameter configuration. Replace the sample values before use.

POST/agent-api/v1/tool/executeX-Api-Key
Request coderequest.sh
curl --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.