douyin fetch_music_search
curl --request POST \
--url https://api.aisa.one/apis/v1/tikhub/douyin/search/fetch_music_search \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"backtrace": "",
"content_type": "0",
"cursor": 0,
"filter_duration": "0",
"keyword": "猫咪",
"publish_time": "0",
"search_id": "",
"sort_type": "0"
}
'import requests
url = "https://api.aisa.one/apis/v1/tikhub/douyin/search/fetch_music_search"
payload = {
"backtrace": "",
"content_type": "0",
"cursor": 0,
"filter_duration": "0",
"keyword": "猫咪",
"publish_time": "0",
"search_id": "",
"sort_type": "0"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
backtrace: '',
content_type: '0',
cursor: 0,
filter_duration: '0',
keyword: '猫咪',
publish_time: '0',
search_id: '',
sort_type: '0'
})
};
fetch('https://api.aisa.one/apis/v1/tikhub/douyin/search/fetch_music_search', 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/search/fetch_music_search",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'backtrace' => '',
'content_type' => '0',
'cursor' => 0,
'filter_duration' => '0',
'keyword' => '猫咪',
'publish_time' => '0',
'search_id' => '',
'sort_type' => '0'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.aisa.one/apis/v1/tikhub/douyin/search/fetch_music_search"
payload := strings.NewReader("{\n \"backtrace\": \"\",\n \"content_type\": \"0\",\n \"cursor\": 0,\n \"filter_duration\": \"0\",\n \"keyword\": \"猫咪\",\n \"publish_time\": \"0\",\n \"search_id\": \"\",\n \"sort_type\": \"0\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
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/search/fetch_music_search")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"backtrace\": \"\",\n \"content_type\": \"0\",\n \"cursor\": 0,\n \"filter_duration\": \"0\",\n \"keyword\": \"猫咪\",\n \"publish_time\": \"0\",\n \"search_id\": \"\",\n \"sort_type\": \"0\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.aisa.one/apis/v1/tikhub/douyin/search/fetch_music_search")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"backtrace\": \"\",\n \"content_type\": \"0\",\n \"cursor\": 0,\n \"filter_duration\": \"0\",\n \"keyword\": \"猫咪\",\n \"publish_time\": \"0\",\n \"search_id\": \"\",\n \"sort_type\": \"0\"\n}"
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"
}Core
douyin fetch_music_search
Fetch music search
POST
https://api.aisa.one
/
apis
/
v1
/
tikhub
/
douyin
/
search
/
fetch_music_search
douyin fetch_music_search
curl --request POST \
--url https://api.aisa.one/apis/v1/tikhub/douyin/search/fetch_music_search \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"backtrace": "",
"content_type": "0",
"cursor": 0,
"filter_duration": "0",
"keyword": "猫咪",
"publish_time": "0",
"search_id": "",
"sort_type": "0"
}
'import requests
url = "https://api.aisa.one/apis/v1/tikhub/douyin/search/fetch_music_search"
payload = {
"backtrace": "",
"content_type": "0",
"cursor": 0,
"filter_duration": "0",
"keyword": "猫咪",
"publish_time": "0",
"search_id": "",
"sort_type": "0"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
backtrace: '',
content_type: '0',
cursor: 0,
filter_duration: '0',
keyword: '猫咪',
publish_time: '0',
search_id: '',
sort_type: '0'
})
};
fetch('https://api.aisa.one/apis/v1/tikhub/douyin/search/fetch_music_search', 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/search/fetch_music_search",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'backtrace' => '',
'content_type' => '0',
'cursor' => 0,
'filter_duration' => '0',
'keyword' => '猫咪',
'publish_time' => '0',
'search_id' => '',
'sort_type' => '0'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.aisa.one/apis/v1/tikhub/douyin/search/fetch_music_search"
payload := strings.NewReader("{\n \"backtrace\": \"\",\n \"content_type\": \"0\",\n \"cursor\": 0,\n \"filter_duration\": \"0\",\n \"keyword\": \"猫咪\",\n \"publish_time\": \"0\",\n \"search_id\": \"\",\n \"sort_type\": \"0\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
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/search/fetch_music_search")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"backtrace\": \"\",\n \"content_type\": \"0\",\n \"cursor\": 0,\n \"filter_duration\": \"0\",\n \"keyword\": \"猫咪\",\n \"publish_time\": \"0\",\n \"search_id\": \"\",\n \"sort_type\": \"0\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.aisa.one/apis/v1/tikhub/douyin/search/fetch_music_search")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"backtrace\": \"\",\n \"content_type\": \"0\",\n \"cursor\": 0,\n \"filter_duration\": \"0\",\n \"keyword\": \"猫咪\",\n \"publish_time\": \"0\",\n \"search_id\": \"\",\n \"sort_type\": \"0\"\n}"
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"
}Fetch music search
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/search/fetch_music_search" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{}' # see request schema below
Request contract
- Method and path: POST /apis/v1/tikhub/douyin/search/fetch_music_search
- Availability: enabled
- Request URL template:
https://api.aisa.one/apis/v1/tikhub/douyin/search/fetch_music_search
{
"operationId": "post_tikhub_douyin_search_fetch_music_search",
"method": "POST",
"path": "/apis/v1/tikhub/douyin/search/fetch_music_search",
"servers": [
{
"url": "https://api.aisa.one"
}
],
"parameters": [],
"security": [
{
"bearerAuth": []
}
],
"requestBody": {
"content": {
"application/json": {
"schema": {
"properties": {
"backtrace": {
"default": "",
"description": "Backtrace for pagination, obtained from the last response",
"title": "Backtrace",
"type": "string"
},
"content_type": {
"default": "0",
"description": "Content type: 0=All, 1=Video, 2=Picture, 3=Article\n\nUsage: Content type filter\n - `0`: Unlimited\n - `1`: Video\n - `2`: Image\n - `3`: Article",
"title": "Content Type",
"type": "string"
},
"cursor": {
"default": 0,
"description": "Offset cursor for pagination, obtained from the last response\n\nUsage: Pagination cursor (0 for first page, use the last response cursor for subsequent pages)",
"title": "Cursor",
"type": "integer"
},
"filter_duration": {
"default": "0",
"description": "Video duration filter: 0=Unlimited, 0-1=Within 1 minute, 1-5=1 to 5 minutes, 5-10000=More than 5 minutes",
"title": "Filter Duration",
"type": "string"
},
"keyword": {
"default": "猫咪",
"description": "Keyword",
"title": "Keyword",
"type": "string"
},
"publish_time": {
"default": "0",
"description": "Publish time filter: 0=Unlimited, 1=Last day, 7=Last week, 180=Last half year",
"title": "Publish Time",
"type": "string"
},
"search_id": {
"default": "",
"description": "Search ID for pagination, obtained from the last response",
"title": "Search Id",
"type": "string"
},
"sort_type": {
"default": "0",
"description": "Sort type: 0=Comprehensive, 1=Most Likes, 2=Latest\n\nUsage: Sorting method\n - `0`: Comprehensive\n - `1`: Most likes\n - `2`: Latest",
"title": "Sort Type",
"type": "string"
}
},
"title": "MusicSearchRequest",
"type": "object"
}
}
},
"required": true
},
"x-aisa-status": "enabled",
"components": {
"securitySchemes": {
"bearerAuth": {
"scheme": "bearer",
"type": "http"
}
}
}
}
Cost and request rules
Request pricing. Default request estimate: $0.01 USD. The final charge depends on actual usage. Your account price may differ; use a request quote where supported.Authorizations
Body
application/json
Response
Successful Response
Response (common fields, actual response may contain more fields)
music: List of music search resultsid_str: Music ID (as string)title: Music titleauthor: Music author's nicknamealbum: Album name (if any)play_url.url_list: List of music play URLsduration: Duration in secondscover_thumb.url_list: List of thumbnail cover URLscover_medium.url_list: List of medium-sized cover URLscover_large.url_list: List of large-sized cover URLsuser_count: Number of videos using this musicis_original: Whether it is original musicis_commerce_music: Whether it is commercial musiclyric_url: Lyrics file URL (if available)strong_beat_url.url_list: Beat timing file URLstags: Music tags- Themes (e.g., Game, Vlog), Moods (e.g., Funny), Genres (e.g., 8-bit, Electronic)
artists: List of associated artists (if any)artist_name: Artist nameuid: Artist UID
cover_color_hsv: Dominant HSV color of the covercan_background_play: Whether background playback is supported
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.