Explore our Marketplace to buy and sell APIs, services, and social media solutions. Connect with a vibrant community of developers, businesses, and creators!

获取学校搜索/Fetch school search

POST

https://api.tikhub.io/api/v1/douyin/search/fetch_school_search

Douyin-Search-API

Last modified:2025-09-16 22:31:04

OperationId:fetch_school_search_api_v1_douyin_search_fetch_school_search_post

[中文]

用途:

获取抖音 App 中学校信息的搜索结果。

根据关键词返回学校名称列表，常用于用户设置学校资料、兴趣推荐等场景。

备注:

本接口专注于学校信息搜索，仅返回学校的名称字段。

初次请求时 cursor 应传 0，分页时使用上一次返回的 cursor。

本接口响应体较简单，适合快速检索学校数据。

参数:

keyword: 搜索关键词，如学校名称 "北京大学"、地区名 "北京"

请求体示例：

payload = {
    "keyword": "北京大学"
}

返回（部分常用字段，实际返回字段更多，一切以实际响应为准）:

schools[]: 学校列表

name: 学校名称（如 "北京大学"、"北京四中"）

extra:

now: 当前服务器时间戳（毫秒）

logid: 请求日志ID

fatal_item_ids: 错误项目ID列表（通常为空）

log_pb:

impr_id: 曝光追踪ID（用于链路追踪）

status_code: 状态码（0=成功）

status_msg: 状态信息（通常为空）

[English]

Purpose:

Fetch school information search results from Douyin App.

Returns a list of school names based on the input keyword, useful for user profile settings, school recommendations, etc.

Notes:

This API focuses on school information search, and only returns school names.

Set cursor to 0 for the first request; for pagination, use the cursor from the last response.

The response structure is simple and lightweight for fast lookup.

Parameters:

keyword: Search keyword, e.g., school name "Peking University" or city "Beijing"

Example Request Body:

payload = {
    "keyword": "Peking University"
}

Response (common fields, actual response may contain more fields):

schools[]: List of schools

name: School name (e.g., "Peking University", "Beijing No.4 High School")

extra:

now: Server timestamp in milliseconds

logid: Log ID for request tracing

fatal_item_ids: List of fatal item IDs (usually empty)

log_pb:

impr_id: Impression ID for tracking

status_code: Status code (0=success)

status_msg: Status message (usually empty)

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Body Params application/json

Example

{
    "keyword": "北京"
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api.tikhub.io/api/v1/douyin/search/fetch_school_search' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "keyword": "北京"
}'

Responses

🟢200OK

application/json

Successful Response

Body

Example

{
    "code": 200,
    "request_id": "string",
    "message": "Request successful. This request will incur a charge.",
    "message_zh": "请求成功，本次请求将被计费。",
    "support": "Discord: https://discord.gg/aMEAS8Xsvz",
    "time": "2025-09-16 03:14:36",
    "time_stamp": 1758017676,
    "time_zone": "America/Los_Angeles",
    "docs": "string",
    "router": "",
    "params": {},
    "data": null
}

🟠422Parameter Error

Modified at 2025-09-16 22:31:04

获取讨论搜索/Fetch discussion search

根据抖音用户ID获取游客星图kolid/Get XingTu kolid by Douyin User ID

获取学校搜索/Fetch school search

[中文]#

用途:#

备注:#

参数:#

请求体示例：#

返回（部分常用字段，实际返回字段更多，一切以实际响应为准）:#

[English]#

Purpose:#

Notes:#

Parameters:#

Example Request Body:#

Response (common fields, actual response may contain more fields):#