Douyin Xingtu Get IP Activity List

4.13 credits/call
ae_douyin_xingtu_get_ip_activity_list

## Purpose Retrieve Xingtu IP calendar activities for a specified time range, with optional industry, category, and status filters. ## Inputs Supply a required `request_body` object with: - `query_start_time` (required string): query start timestamp, e.g. `"1767196800"`. - `query_end_time` (required string): query end timestamp, e.g. `"1774972799"`. - `industry_id_list` (optional string array or null): industry IDs. Examples: `["1930"]` for beauty, `["1901"]` for 3C and electronics, `["1903"]` for food and beverage. - `category_list` (optional integer array or null): 1 = Xingtu major event, 2 = e-commerce occasion, 3 = emotional occasion, 4 = creative marketing, 5 = industry activity. - `status_list` (optional integer array or null): 40 = preparing, 50 = recruiting, 30 = resources online, 20 = ended. ## Result Returns a response containing IP calendar activity list data in `data`. This field may be null; the available schema does not specify the fields of individual activities. The tool queries activities; it does not create activities or enroll participants.

Social
4.13 credits/call

Pricing

4.13 credits/call
ConditionCharge
Each call4.13 credits/call

4.13 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.

ParameterTypeRequiredDescriptionDefault
request_bodyobjectYes查询 IP 日历活动列表的请求体对象,包含必填的查询开始时间戳 query_start_time 和查询结束时间戳 query_end_time,以及可选的行业 ID 列表 industry_id_list、IP 类型列表 category_list 和 IP 状态列表 status_list。/ Request body object for querying IP calendar activities, containing the required query start and end timestamps (query_start_time and query_end_time) and optional industry ID, IP category, and IP status lists (industry_id_list, category_list, and status_list).—
request_body.status_listarray | nullNoIP状态列表/IP status list—
request_body.category_listarray | nullNoIP类型列表/IP category list—
request_body.query_end_timestringYes查询结束时间戳/Query end timestamp—
request_body.industry_id_listarray | nullNo行业ID列表/Industry ID list—
request_body.query_start_timestringYes查询开始时间戳/Query start timestamp—

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_xingtu_get_ip_activity_list' \
  --header "X-Api-Key: $AGENTEARTH_API_KEY" \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "params": {
    "request_body": {
      "query_end_time": "xxx",
      "query_start_time": "xxx"
    }
  }
}'

No response example available yet.