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

获取综合搜索 V4/Fetch general search V4

POST

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

Douyin-Search-API

Last modified:2025-11-02 06:46:59

OperationId:fetch_general_search_v4_api_v1_douyin_search_fetch_general_search_v4_post

[中文]

用途:

获取指定关键词的综合搜索结果，此接口有概率失败，如果失败请使用同样的参数重新请求 1-3次。 ### 参数:

keyword: 关键词

offset: 偏移量

sort_type: 0:综合排序 1:最多点赞 2:最新发布

publish_time: 0:不限 1:最近一天 7:最近一周 180:最近半年

filter_duration: 0:不限 0-1:1分钟以内 1-5:1-5分钟 5-10000:5分钟以上

content_type: 0:不限 1:视频 2:图集

search_id: 搜索id，第一次请求时为空，第二次翻页时需要提供，需要从上一次请求的返回响应中获取。

例如: search_id = "2024083107320448E367ECDCCC6B71F7F3"

JSON Path-1 : $.data.extra.logid

JSON Path-2 : $.data.log_pb.impr_id

综合搜索结果

[English]

Purpose:

Get comprehensive search results of specified keywords, this interface may fail, if it fails, please use the same parameters to request 1-3 times again.

Parameters:

keyword: Keyword

offset: Offset

sort_type: 0: Comprehensive sorting 1: Most likes 2: Latest release

publish_time: 0: Unlimited 1: Last day 7: Last week 180: Last half year

filter_duration: 0: Unlimited 0-1: Within 1 minute 1-5: 1-5 minutes 5-10000: More than 5 minutes

content_type: 0: Unlimited 1: Video 2: Album

search_id: Search id, empty for the first request, need to provide for the second paging, need to get it from the return response of the last request.

For example: search_id = "2024083107320448E367ECDCCC6B71F7F3"

JSON Path-1 : $.data.extra.logid

JSON Path-2 : $.data.log_pb.impr_id

Return:

Comprehensive search results

[示例/Example]：

payload = {
    "keyword": "中华娘",
    "offset": 0,
    "sort_type": "0",
    "publish_time": "0",
    "filter_duration": "0",
    "content_type": "0",
    "search_id": ""
}

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

Body Params application/jsonRequired

Example

{
    "keyword": "猫咪",
    "offset": 0,
    "sort_type": "0",
    "publish_time": "0",
    "filter_duration": "0",
    "content_type": "0",
    "search_id": ""
}

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_general_search_v4' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "keyword": "猫咪",
    "offset": 0,
    "sort_type": "0",
    "publish_time": "0",
    "filter_duration": "0",
    "content_type": "0",
    "search_id": ""
}'

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": "string",
    "time_stamp": 0,
    "time_zone": "America/Los_Angeles",
    "docs": "string",
    "cache_message": "string",
    "cache_message_zh": "string",
    "cache_url": "string",
    "router": "",
    "params": {},
    "data": null
}

🟠422Parameter Error

Modified at 2025-11-02 06:46:59

获取综合搜索 V3/Fetch general search V3

获取综合搜索 V4/Fetch general search V4

[中文]#

用途:#

返回:#

[English]#

Purpose:#

Parameters:#

Return:#

[示例/Example]：#