Douyin Search Fetch School Search
## Purpose Search for school names available in Douyin using a school-name or location keyword, for example when finding a school to select in a profile. ## Input - `request_body` (required object): Contains the search input. - `request_body.keyword` (optional string): A school name or location, such as `北京大学` or `北京`. The schema default is `北京`. Example: ```json {"request_body":{"keyword":"北京大学"}} ``` ## Return value The response includes a `code` status field and a `data` payload. Documented search content includes a `schools` list whose entries contain `name`, along with `status_code` (`0` means success) and `status_msg`. Additional metadata may include timestamps and request-tracing identifiers. The `data` schema is open-ended and permits null; inspect the actual response for available fields. ## Limitations This tool searches school names, not videos, accounts, or detailed school profiles. It does not expose a cursor or other pagination input. Search matches are not verified institutional records.
Pricing
| Condition | Charge |
|---|---|
| Each call | 20.65 credits/call |
20.65 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 |
|---|---|---|---|---|
request_body | object | Yes | 学校名称搜索的请求体对象,其中 keyword 用于指定学校名称或所在地区等搜索关键词。 / Request body for searching school names; keyword specifies a school name or location to search for. | — |
request_body.keyword | string | No | 关键词,如学校名称或所在地区 / Keyword, such as school name or location | 北京 |
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_search_fetch_school_search' \
--header "X-Api-Key: $AGENTEARTH_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"params": {
"request_body": {}
}
}'No response example available yet.

