douyin fetch_item_query
curl --request POST \
--url https://api.aisa.one/apis/v1/tikhub/douyin/index/fetch_item_query \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.aisa.one/apis/v1/tikhub/douyin/index/fetch_item_query"
headers = {"Authorization": "Bearer <token>"}
response = requests.post(url, headers=headers)
print(response.text)const options = {method: 'POST', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.aisa.one/apis/v1/tikhub/douyin/index/fetch_item_query', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.aisa.one/apis/v1/tikhub/douyin/index/fetch_item_query",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.aisa.one/apis/v1/tikhub/douyin/index/fetch_item_query"
req, _ := http.NewRequest("POST", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.aisa.one/apis/v1/tikhub/douyin/index/fetch_item_query")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.aisa.one/apis/v1/tikhub/douyin/index/fetch_item_query")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"cache_message": "This response is cached and accessible via the URL below for 24 hours at no extra cost. The cache is for request tracing only — it doesn't affect the API's data freshness and won't be returned through the API again.",
"cache_message_zh": "本次响应已缓存，可通过下方 URL 直接查看，有效期 24 小时，访问缓存链接无额外费用。缓存仅用于请求溯源，不影响接口数据的时效性，也不会再次通过接口返回。",
"cache_url": "<string>",
"code": 200,
"data": "<unknown>",
"docs": "<string>",
"message": "Request successful. This request will incur a charge.",
"message_zh": "请求成功，本次请求将被计费。",
"params": {},
"request_id": "<string>",
"router": "",
"support": "Discord: https://discord.gg/aMEAS8Xsvz",
"time": "<string>",
"time_stamp": 123,
"time_zone": "America/Los_Angeles"
}Commercial
douyin fetch_item_query
Video search results
POST
https://api.aisa.one
/
apis
/
v1
/
tikhub
/
douyin
/
index
/
fetch_item_query
douyin fetch_item_query
curl --request POST \
--url https://api.aisa.one/apis/v1/tikhub/douyin/index/fetch_item_query \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.aisa.one/apis/v1/tikhub/douyin/index/fetch_item_query"
headers = {"Authorization": "Bearer <token>"}
response = requests.post(url, headers=headers)
print(response.text)const options = {method: 'POST', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.aisa.one/apis/v1/tikhub/douyin/index/fetch_item_query', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.aisa.one/apis/v1/tikhub/douyin/index/fetch_item_query",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.aisa.one/apis/v1/tikhub/douyin/index/fetch_item_query"
req, _ := http.NewRequest("POST", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.aisa.one/apis/v1/tikhub/douyin/index/fetch_item_query")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.aisa.one/apis/v1/tikhub/douyin/index/fetch_item_query")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"cache_message": "This response is cached and accessible via the URL below for 24 hours at no extra cost. The cache is for request tracing only — it doesn't affect the API's data freshness and won't be returned through the API again.",
"cache_message_zh": "本次响应已缓存，可通过下方 URL 直接查看，有效期 24 小时，访问缓存链接无额外费用。缓存仅用于请求溯源，不影响接口数据的时效性，也不会再次通过接口返回。",
"cache_url": "<string>",
"code": 200,
"data": "<unknown>",
"docs": "<string>",
"message": "Request successful. This request will incur a charge.",
"message_zh": "请求成功，本次请求将被计费。",
"params": {},
"request_id": "<string>",
"router": "",
"support": "Discord: https://discord.gg/aMEAS8Xsvz",
"time": "<string>",
"time_stamp": 123,
"time_zone": "America/Los_Angeles"
}Video search results
Pricing — billed per successful call; the final charge scales by your plan multiplier. Charged only when the upstream response body
code is 200.
Example
curl -X POST "https://api.aisa.one/apis/v1/tikhub/douyin/index/fetch_item_query" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{}'
Request contract
- Method and path: POST /apis/v1/tikhub/douyin/index/fetch_item_query
- Availability: enabled
- Request URL template:
https://api.aisa.one/apis/v1/tikhub/douyin/index/fetch_item_query - category_id: query; optional
- date_type: query; optional
- duration_type: query; optional
- label_type: query; optional
- query: query; required
- Runtime facts: 85ae03121f63417c9ff9d57a0fd59fdc6386fd71e2dc732a002843e6d8979d87
{
"operationId": "post_tikhub_douyin_index_fetch_item_query",
"method": "POST",
"path": "/apis/v1/tikhub/douyin/index/fetch_item_query",
"servers": [
{
"url": "https://api.aisa.one"
}
],
"parameters": [
{
"description": "Category ID as a string; default \"0\" selects all categories. To discover valid IDs, call `GET /tikhub/douyin/index/fetch_item_filter_options` (operationId: `get_tikhub_douyin_index_fetch_item_filter_options`) and use the id of an entry in the returned categories list. Common examples: \"601\"=Drama, \"602\"=Celebrity, \"603\"=Variety, \"604\"=Movie, \"605\"=TV Series, \"606\"=Music, \"607\"=Anime, \"608\"=Games, \"615\"=Tech, \"628\"=Food, \"629\"=Travel, \"631\"=Fashion.",
"in": "query",
"name": "category_id",
"required": false,
"schema": {
"default": "0",
"description": "Category ID as a string; default \"0\" selects all categories. To discover valid IDs, call `GET /tikhub/douyin/index/fetch_item_filter_options` (operationId: `get_tikhub_douyin_index_fetch_item_filter_options`) and use the id of an entry in the returned categories list. Common examples: \"601\"=Drama, \"602\"=Celebrity, \"603\"=Variety, \"604\"=Movie, \"605\"=TV Series, \"606\"=Music, \"607\"=Anime, \"608\"=Games, \"615\"=Tech, \"628\"=Food, \"629\"=Travel, \"631\"=Fashion.",
"title": "Category Id",
"type": "string"
}
},
{
"description": "Publication date filter as an integer; default 0 selects any date. Values: 0=any, 3=last 3 days, 7=last 7 days, 30=last 30 days. To discover current options, call `GET /tikhub/douyin/index/fetch_item_filter_options` (operationId: `get_tikhub_douyin_index_fetch_item_filter_options`) and use the id of an entry in the returned date_types list.",
"in": "query",
"name": "date_type",
"required": false,
"schema": {
"default": 0,
"description": "Publication date filter as an integer; default 0 selects any date. Values: 0=any, 3=last 3 days, 7=last 7 days, 30=last 30 days. To discover current options, call `GET /tikhub/douyin/index/fetch_item_filter_options` (operationId: `get_tikhub_douyin_index_fetch_item_filter_options`) and use the id of an entry in the returned date_types list.",
"title": "Date Type",
"type": "integer"
}
},
{
"description": "Video duration filter as an integer; default 0 selects any duration. Values: 0=any, 1=0-15s, 6=15-60s, 7=60-120s, 8=120-180s, 9=over 180s. To discover current options, call `GET /tikhub/douyin/index/fetch_item_filter_options` (operationId: `get_tikhub_douyin_index_fetch_item_filter_options`) and use the id of an entry in the returned duration_types list.",
"in": "query",
"name": "duration_type",
"required": false,
"schema": {
"default": 0,
"description": "Video duration filter as an integer; default 0 selects any duration. Values: 0=any, 1=0-15s, 6=15-60s, 7=60-120s, 8=120-180s, 9=over 180s. To discover current options, call `GET /tikhub/douyin/index/fetch_item_filter_options` (operationId: `get_tikhub_douyin_index_fetch_item_filter_options`) and use the id of an entry in the returned duration_types list.",
"title": "Duration Type",
"type": "integer"
}
},
{
"description": "Video quality tag as an integer; default 0 selects any type. Values: 0=any, 1=low-follower hit, 2=high completion rate, 3=high follower growth, 4=high like rate. To discover current options, call `GET /tikhub/douyin/index/fetch_item_filter_options` (operationId: `get_tikhub_douyin_index_fetch_item_filter_options`) and use the id of an entry in the returned label_types list.",
"in": "query",
"name": "label_type",
"required": false,
"schema": {
"default": 0,
"description": "Video quality tag as an integer; default 0 selects any type. Values: 0=any, 1=low-follower hit, 2=high completion rate, 3=high follower growth, 4=high like rate. To discover current options, call `GET /tikhub/douyin/index/fetch_item_filter_options` (operationId: `get_tikhub_douyin_index_fetch_item_filter_options`) and use the id of an entry in the returned label_types list.",
"title": "Label Type",
"type": "integer"
}
},
{
"description": "Search keyword",
"in": "query",
"name": "query",
"required": true,
"schema": {
"description": "Search keyword",
"title": "Query",
"type": "string"
}
}
],
"security": [
{
"bearerAuth": []
}
],
"x-aisa-status": "enabled",
"x-aisa-pricing": {
"cost_contract": "fixed_success",
"customer_multiplier": 1.0,
"customer_pricing": "provider_cost_multiplier",
"default_request_estimate_usd": 0.001,
"estimate_source": "profile_seed",
"evidence_source": "request_snapshot"
},
"components": {
"securitySchemes": {
"bearerAuth": {
"scheme": "bearer",
"type": "http"
}
}
}
}
Cost and request rules
Published reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ. Published reference values are not an account-specific quote or a settled charge. For endpoints supporting X-AISA-Cost-Mode: quote, obtain a free quote for your exact request before execution; reconcile the settled cost with response metadata and Usage Logs. USD amounts use 1,000,000 integer micro-USD per dollar.- Default request reference estimate (USD): 0.001
- Cost contract: fixed_success
- Published reference multiplier: 1.0
- Settlement evidence source: request_snapshot
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Query Parameters
Category ID as a string; default "0" selects all categories. To discover valid IDs, call GET /tikhub/douyin/index/fetch_item_filter_options (operationId: get_tikhub_douyin_index_fetch_item_filter_options) and use the id of an entry in the returned categories list. Common examples: "601"=Drama, "602"=Celebrity, "603"=Variety, "604"=Movie, "605"=TV Series, "606"=Music, "607"=Anime, "608"=Games, "615"=Tech, "628"=Food, "629"=Travel, "631"=Fashion.
Publication date filter as an integer; default 0 selects any date. Values: 0=any, 3=last 3 days, 7=last 7 days, 30=last 30 days. To discover current options, call GET /tikhub/douyin/index/fetch_item_filter_options (operationId: get_tikhub_douyin_index_fetch_item_filter_options) and use the id of an entry in the returned date_types list.
Video duration filter as an integer; default 0 selects any duration. Values: 0=any, 1=0-15s, 6=15-60s, 7=60-120s, 8=120-180s, 9=over 180s. To discover current options, call GET /tikhub/douyin/index/fetch_item_filter_options (operationId: get_tikhub_douyin_index_fetch_item_filter_options) and use the id of an entry in the returned duration_types list.
Video quality tag as an integer; default 0 selects any type. Values: 0=any, 1=low-follower hit, 2=high completion rate, 3=high follower growth, 4=high like rate. To discover current options, call GET /tikhub/douyin/index/fetch_item_filter_options (operationId: get_tikhub_douyin_index_fetch_item_filter_options) and use the id of an entry in the returned label_types list.
Search keyword
Response
Successful Response
Return
- Video list. Each item contains: itemId, itemTitle, cover, duration, publish time, play count, like count, comment count, share count, author id/nickname/followers, etc.
cache_message
string | null
default:This response is cached and accessible via the URL below for 24 hours at no extra cost. The cache is for request tracing only — it doesn't affect the API's data freshness and won't be returned through the API again.
Cache message (EN-US)
cache_message_zh
string | null
default:本次响应已缓存，可通过下方 URL 直接查看，有效期 24 小时，访问缓存链接无额外费用。缓存仅用于请求溯源，不影响接口数据的时效性，也不会再次通过接口返回。
Cache message (ZH-CN)
The URL to access the cached result
HTTP status code
Endpoint-specific response payload. The official shared model does not declare a fixed type or field set. Use the operation's documented return fields or response example; an operation-specific schema, when present, describes the documented fields. Undocumented fields must be read from the actual response rather than assumed.
Link to the API Swagger documentation for this endpoint
Response message (EN-US)
Response message (ZH-CN)
The parameters used in the request
Unique request identifier
The endpoint that generated this response
Support message
The time the response was generated
The timestamp the response was generated
The timezone of the response time