Reference example
# Fixed reference example. Playground inputs do not update this sample.
curl --request POST \
--url https://api.aisa.one/apis/v1/tikhub/douyin/creator_v2/fetch_item_list \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"cookie": "Your_Cookie_Here",
"start_time": 1758988800000,
"end_time": 1760198399000,
"count": 10,
"order_by": 1,
"fields": "metrics,review,visibility",
"need_cooperation": true,
"need_long_article": true
}'curl --request POST \
--url https://api.aisa.one/apis/v1/tikhub/douyin/creator_v2/fetch_item_list \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"cookie": "Your_Cookie_Here",
"end_time": 1760198399000,
"start_time": 1758988800000
}
'import requests
url = "https://api.aisa.one/apis/v1/tikhub/douyin/creator_v2/fetch_item_list"
payload = {
"cookie": "Your_Cookie_Here",
"end_time": 1760198399000,
"start_time": 1758988800000
}
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({cookie: 'Your_Cookie_Here', end_time: 1760198399000, start_time: 1758988800000})
};
fetch('https://api.aisa.one/apis/v1/tikhub/douyin/creator_v2/fetch_item_list', 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/creator_v2/fetch_item_list",
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([
'cookie' => 'Your_Cookie_Here',
'end_time' => 1760198399000,
'start_time' => 1758988800000
]),
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/creator_v2/fetch_item_list"
payload := strings.NewReader("{\n \"cookie\": \"Your_Cookie_Here\",\n \"end_time\": 1760198399000,\n \"start_time\": 1758988800000\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/creator_v2/fetch_item_list")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"cookie\": \"Your_Cookie_Here\",\n \"end_time\": 1760198399000,\n \"start_time\": 1758988800000\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.aisa.one/apis/v1/tikhub/douyin/creator_v2/fetch_item_list")
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 \"cookie\": \"Your_Cookie_Here\",\n \"end_time\": 1760198399000,\n \"start_time\": 1758988800000\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"
}商业
douyin fetch_item_list
获取投稿作品列表
POST
https://api.aisa.one
/
apis
/
v1
/
tikhub
/
douyin
/
creator_v2
/
fetch_item_list
Reference example
# Fixed reference example. Playground inputs do not update this sample.
curl --request POST \
--url https://api.aisa.one/apis/v1/tikhub/douyin/creator_v2/fetch_item_list \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"cookie": "Your_Cookie_Here",
"start_time": 1758988800000,
"end_time": 1760198399000,
"count": 10,
"order_by": 1,
"fields": "metrics,review,visibility",
"need_cooperation": true,
"need_long_article": true
}'curl --request POST \
--url https://api.aisa.one/apis/v1/tikhub/douyin/creator_v2/fetch_item_list \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"cookie": "Your_Cookie_Here",
"end_time": 1760198399000,
"start_time": 1758988800000
}
'import requests
url = "https://api.aisa.one/apis/v1/tikhub/douyin/creator_v2/fetch_item_list"
payload = {
"cookie": "Your_Cookie_Here",
"end_time": 1760198399000,
"start_time": 1758988800000
}
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({cookie: 'Your_Cookie_Here', end_time: 1760198399000, start_time: 1758988800000})
};
fetch('https://api.aisa.one/apis/v1/tikhub/douyin/creator_v2/fetch_item_list', 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/creator_v2/fetch_item_list",
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([
'cookie' => 'Your_Cookie_Here',
'end_time' => 1760198399000,
'start_time' => 1758988800000
]),
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/creator_v2/fetch_item_list"
payload := strings.NewReader("{\n \"cookie\": \"Your_Cookie_Here\",\n \"end_time\": 1760198399000,\n \"start_time\": 1758988800000\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/creator_v2/fetch_item_list")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"cookie\": \"Your_Cookie_Here\",\n \"end_time\": 1760198399000,\n \"start_time\": 1758988800000\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.aisa.one/apis/v1/tikhub/douyin/creator_v2/fetch_item_list")
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 \"cookie\": \"Your_Cookie_Here\",\n \"end_time\": 1760198399000,\n \"start_time\": 1758988800000\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"
}获取投稿作品列表
计费 — 按成功调用计费，最终扣费按你的套餐倍率浮动。仅当上游响应体
code 为 200 时计费。
响应结构尚未完整文档化 —— 以实际调用为准。
示例
curl -X POST "https://api.aisa.one/apis/v1/tikhub/douyin/creator_v2/fetch_item_list" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{}' # 请求体结构见下方 schema
请求规范
- 方法与路径: POST /apis/v1/tikhub/douyin/creator_v2/fetch_item_list
- 可用状态: enabled
- 请求 URL 模板:
https://api.aisa.one/apis/v1/tikhub/douyin/creator_v2/fetch_item_list - Runtime 事实版本: 85ae03121f63417c9ff9d57a0fd59fdc6386fd71e2dc732a002843e6d8979d87
{
"operationId": "post_tikhub_douyin_creator_v2_fetch_item_list",
"method": "POST",
"path": "/apis/v1/tikhub/douyin/creator_v2/fetch_item_list",
"servers": [
{
"url": "https://api.aisa.one"
}
],
"parameters": [],
"security": [
{
"bearerAuth": []
}
],
"requestBody": {
"content": {
"application/json": {
"example": {
"cookie": "Your_Cookie_Here",
"count": 10,
"end_time": 1760198399000,
"fields": "metrics,review,visibility",
"need_cooperation": true,
"need_long_article": true,
"order_by": 1,
"start_time": 1758988800000
},
"schema": {
"allOf": [
{
"description": "Item List Request Model",
"properties": {
"cookie": {
"description": "User's Douyin Creator Platform Cookie (required, transmitted in request body)",
"example": "Your_Cookie_Here",
"title": "Cookie",
"type": "string"
},
"count": {
"default": 10,
"description": "Count per page (max 100)\n\nUsage: Number of items per page, default 10, max 100 (optional)",
"example": 10,
"maximum": 100,
"title": "Count",
"type": "integer"
},
"cursor": {
"description": "Pagination cursor, don't pass for first request, use returned cursor for pagination (optional)",
"title": "Cursor",
"type": [
"integer",
"null"
]
},
"end_time": {
"description": "End time timestamp (milliseconds)",
"example": 1760198399000,
"title": "End Time",
"type": "integer"
},
"fields": {
"default": "metrics,review,visibility",
"description": "Fields to return, default \"metrics,review,visibility\" (optional)\n - metrics: Traffic metrics (views, likes, comments, shares, favorites, etc.)\n - review: Review status\n - visibility: Visibility status",
"example": "metrics,review,visibility",
"title": "Fields",
"type": "string"
},
"need_cooperation": {
"default": true,
"description": "Need cooperation info",
"example": true,
"title": "Need Cooperation",
"type": "boolean"
},
"need_long_article": {
"default": true,
"description": "Include long articles",
"example": true,
"title": "Need Long Article",
"type": "boolean"
},
"order_by": {
"default": 1,
"description": "Order by (1-26): 1=Publish time (newest first), 2=Publish time (oldest first), 3=Views (desc), 4=Views (asc), 5=Likes (desc), 6=Likes (asc), 7=Comments (desc), 8=Comments (asc), 9=Shares (desc), 10=Shares (asc), 11=Favorites (desc), 12=Favorites (asc), 13=2s bounce rate (desc), 14=2s bounce rate (asc), 15=5s completion rate (desc), 16=5s completion rate (asc), 17=Completion rate (desc), 18=Completion rate (asc), 19=Cover CTR (desc), 20=Cover CTR (asc), 21=Avg watch duration (desc), 22=Avg watch duration (asc), 23=Profile visits (desc), 24=Profile visits (asc), 25=Follower growth (desc), 26=Follower growth (asc)",
"example": 1,
"title": "Order By",
"type": "integer"
},
"start_time": {
"description": "Start timestamp (milliseconds)",
"example": 1758988800000,
"title": "Start Time",
"type": "integer"
}
},
"required": [
"cookie",
"start_time",
"end_time"
],
"title": "ItemListRequest",
"type": "object"
}
],
"description": "Item list request parameters"
}
}
},
"required": true
},
"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"
}
}
}
}
费用与请求规则
公开参考价格：每次成功请求 $0.001 USD。 最终费用以账户适用价格及实际结算为准。 公开参考值不是你的账户报价或最终扣费。对于支持 X-AISA-Cost-Mode: quote 的接口，执行前请针对完整请求获取免费报价；执行后通过响应费用元数据和 Usage Logs 核对结算费用。1 USD 等于 1,000,000 个整数 micro-USD。- 默认请求参考估价（USD）: 0.001
- 计费依据: fixed_success
- 公开参考倍率: 1.0
- 结算证据来源: request_snapshot
授权
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
请求体
application/json
Item list request parameters
User's Douyin Creator Platform Cookie (required, transmitted in request body)
示例:
"Your_Cookie_Here"
End time timestamp (milliseconds)
示例:
1760198399000
Start timestamp (milliseconds)
示例:
1758988800000
Count per page (max 100)
Usage: Number of items per page, default 10, max 100 (optional)
必填范围:
x <= 100示例:
10
Pagination cursor, don't pass for first request, use returned cursor for pagination (optional)
Fields to return, default "metrics,review,visibility" (optional)
- metrics: Traffic metrics (views, likes, comments, shares, favorites, etc.)
- review: Review status
- visibility: Visibility status
示例:
"metrics,review,visibility"
Need cooperation info
示例:
true
Include long articles
示例:
true
Order by (1-26): 1=Publish time (newest first), 2=Publish time (oldest first), 3=Views (desc), 4=Views (asc), 5=Likes (desc), 6=Likes (asc), 7=Comments (desc), 8=Comments (asc), 9=Shares (desc), 10=Shares (asc), 11=Favorites (desc), 12=Favorites (asc), 13=2s bounce rate (desc), 14=2s bounce rate (asc), 15=5s completion rate (desc), 16=5s completion rate (asc), 17=Completion rate (desc), 18=Completion rate (asc), 19=Cover CTR (desc), 20=Cover CTR (asc), 21=Avg watch duration (desc), 22=Avg watch duration (asc), 23=Profile visits (desc), 24=Profile visits (asc), 25=Follower growth (desc), 26=Follower growth (asc)
示例:
1
响应
Successful response. The outer object follows ResponseModel; the endpoint-specific payload is in data.
Return
- Item list data with detailed metric information
- has_more: Whether there are more items
- cursor: Cursor for next page, used for pagination
- items: Array of items
cache_message
string | null
默认值: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
默认值:本次响应已缓存，可通过下方 URL 直接查看，有效期 24 小时，访问缓存链接无额外费用。缓存仅用于请求溯源，不影响接口数据的时效性，也不会再次通过接口返回。
Cache message (ZH-CN)
The URL to access the cached result
HTTP 状态码
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